Get revocation list

Get signed list of revoked proofs for offline verification. When has_more is true the list was truncated — re-baseline and prefer the Token Status List (status_list_uri), which never truncates and also covers suspension.

get/api/v1/proofs/revoked

Request

Base URL: https://api.proof.holdings
URL: https://api.proof.holdings/api/v1/proofs/revoked
Auth: none declared

Response

Revocation list

issued_atstring date-time required

When this list was generated

countnumber required

Number of entries in revoked

has_moreboolean required

True when a source hit its cap and the list may be incomplete — re-baseline and prefer the Token Status List, which never truncates

status_list_uristring required

The Token Status List endpoint — the scalable status channel that also covers SUSPENDED and can retract entries (an unsuspended bit flips back; a CRL entry cached by a ?since poller cannot be unpublished)

signaturestring nullable required

Signature over the payload for offline verification, in the algorithm of the key kid names (null when unsigned)

kidstring nullable required

Key id of the signing key, for JWKS lookup

Example response

{
  "revoked": [
    {
      "public_proof_id": "ph_ctl_0123456789abcdef0123456789abcdef",
      "proof_type": "user_asset",
      "reason": "user_request"
    }
  ],
  "status_list_uri": "https://api.proof.holdings/api/v1/proofs/status-list"
}

Changes

No recorded changes to this operation across all 1 revision of this API.