v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-05730512.7 KB

Status Lists

Fetch a Token Status List (whole list)

Public, unauthenticated fetch of an entire IETF Token Status List compressed bitstring used for SD-JWT VC (Selective-Disclosure JWT Verifiable Credential) revocation and suspension. Verifiers fetch the whole list and read the bit at a credential's status index. Serving the full list instead of a single entry helps defend against correlation.

get/v1/status-lists/{slug}/{uuid}

Path parameters

slugstring required

The issuer tenant's URL slug. It scopes the lookup to that tenant.

uuidstring uuid required

UUID of the status list to fetch. It must belong to the tenant identified by slug.

Response

The full status list as a base64url-encoded bitstring plus its URI and size.

uristring uri

Canonical absolute URI of this status list. Credentials reference this value from their status claim.

sizeinteger

Number of bits in the status list.

bits_b64string byte

Status-list bitstring encoded as a base64url string. Decode it and read the bit at a credential's status index.

Example response

{
  "uri": "https://acme-air.didit.me/v1/status-lists/acme-air/9f0a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c",
  "size": 131072,
  "bits_b64": "AAAAAAAAAAAAAAAAAAAAAA"
}