Read records back · Docs

One record

GET /api/v1/integration/entitlements/<external_id>
Authorization: Bearer wik_...

Returns the same item a write returns, or 404 with not_found. Use it when you have lost a public_id. It reads only what this key's provider wrote.

Everything your key holds

GET /api/v1/integration/entitlements?limit=500&cursor=<next>
Authorization: Bearer wik_...

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

Every record your key's provider holds, in external_id order, 500 to a page unless limit asks for fewer. limit is a whole number from 1 to 500. Pass next back as cursor for the following page, and stop when next is null.

A cursor is opaque. Store it only to finish the walk you started. A cursor this API never returned is refused with invalid_request.

async function everything(key: string) {
  const held = []
  let cursor: string | null = null
  do {
    const url = new URL('https://3dwarden.com/api/v1/integration/entitlements')
    if (cursor) url.searchParams.set('cursor', cursor)
    const res = await fetch(url, { headers: { Authorization: `Bearer ${key}` } })
    if (!res.ok) throw new Error(`${res.status} ${(await res.json()).code}`)
    const page = await res.json()
    held.push(...page.records)
    cursor = page.next
  } while (cursor)
  return held
}

import requests

def everything(key):
    held, cursor = [], None
    while True:
        res = requests.get(
            "https://3dwarden.com/api/v1/integration/entitlements",
            headers={"Authorization": f"Bearer {key}"},
            params={"cursor": cursor} if cursor else None,
            timeout=30,
        )
        res.raise_for_status()
        page = res.json()
        held.extend(page["records"])
        cursor = page["next"]
        if not cursor:
            return held

Diff against your own records

A member you hold that the list lacks was never written. A record the list has that you no longer hold is still there, because Warden never removes a record by omission. Send it as inactive.

Each page is one request against the key's allowance.

What you cannot read yet

The identities your members added through an enrollment invitation, and only what changed since a given time. See what is not available yet.