Check Revocation Status

View as Markdown
When to use

You hold a credential and want to confirm it has not been revoked. The status check is also performed automatically every time you open a credential’s detail page.

Before you begin

You have a credential ID.

Steps (manual)
$curl https://adid.dev/api/v1/credentials/urn:uuid:c5b7e3.../status

(No auth needed — this endpoint is public, registered at router.go:68.)

Response:

1{
2 "credentialId":"urn:uuid:c5b7e3...",
3 "revoked": false,
4 "statusListId":"abcd",
5 "statusListIndex": 42,
6 "checkedAt":"2026-04-26T12:00:00Z"
7}
How it works under the hood

The handler reads the bit at the credential’s statusListIndex from the RevocationRegistry contract. Bit 1 = revoked, bit 0 = active. See §4.4.3 for the bitstring encoding.

Troubleshooting
CodeCauseFix
404 CREDENTIAL_NOT_FOUNDCredential never existed or was deleted from indexConfirm credential ID.
502 CHAIN_UNREACHABLERPC downRetry.