API reference

Get an entitlement

Read one record back by your own id, to find its public id again.

GET/api/v1/integration/entitlements/{external_id}

Reads only what this key's provider wrote. Encode the id for a URL if it has characters that need it.

Request

curl -sS "https://3dwarden.com/api/v1/integration/entitlements/member-1001" \
  -H "Authorization: Bearer $WARDEN_KEY"

const res = await fetch(`https://3dwarden.com/api/v1/integration/entitlements/${encodeURIComponent(externalId)}`, {
  headers: { Authorization: `Bearer ${process.env.WARDEN_KEY}` },
})
if (res.status === 404) return null
if (!res.ok) throw new Error(`${res.status} ${(await res.json()).code}`)
const { public_id } = await res.json()

import os, requests
from urllib.parse import quote

res = requests.get(
    f"https://3dwarden.com/api/v1/integration/entitlements/{quote(external_id, safe='')}",
    headers={"Authorization": f"Bearer {os.environ['WARDEN_KEY']}"},
    timeout=30,
)
public_id = None if res.status_code == 404 else res.json()["public_id"]

Response, 200

{
  "external_id": "member-1001",
  "public_id": "q3Zr8mW1x0aB4cD5eF6gHi",
  "normalized_state": "active",
  "capabilities": ["physical_sales"],
  "last_synced_at": "2026-09-21T18:04:11.123456+00:00",
  "retired": false,
  "verify_url": "https://3dwarden.com/verify/q3Zr8mW1x0aB4cD5eF6gHi"
}

Errors

Status	Code	When
401	`invalid_key`
404	`not_found`	This key's provider never wrote that id.
429	`rate_limited`

Request

curl -sS "https://3dwarden.com/api/v1/integration/entitlements/member-1001" \  -H "Authorization: Bearer $WARDEN_KEY"

const res = await fetch(`https://3dwarden.com/api/v1/integration/entitlements/${encodeURIComponent(externalId)}`, {  headers: { Authorization: `Bearer ${process.env.WARDEN_KEY}` },})if (res.status === 404) return nullif (!res.ok) throw new Error(`${res.status} ${(await res.json()).code}`)const { public_id } = await res.json()

import os, requestsfrom urllib.parse import quote res = requests.get(    f"https://3dwarden.com/api/v1/integration/entitlements/{quote(external_id, safe='')}",    headers={"Authorization": f"Bearer {os.environ['WARDEN_KEY']}"},    timeout=30,)public_id = None if res.status_code == 404 else res.json()["public_id"]

Response, 200

{  "external_id": "member-1001",  "public_id": "q3Zr8mW1x0aB4cD5eF6gHi",  "normalized_state": "active",  "capabilities": ["physical_sales"],  "last_synced_at": "2026-09-21T18:04:11.123456+00:00",  "retired": false,  "verify_url": "https://3dwarden.com/verify/q3Zr8mW1x0aB4cD5eF6gHi"}