v8

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

Credentials

Revoke a credential

Permanently revoke an issued credential. Revocation is terminal for the captured lifecycle. The response returns the updated credential record.

post/v1/credentials/{uuid}/revoke

Path parameters

uuidstring required

UUID of the issued credential to revoke.

Request body

object required

Response

The credential was revoked.

uuidstring uuid

Unique identifier of the issued credential.

vctstring

VCT (Verifiable Credential Type) value of the issued credential.

issstring uri

Issuer URL that issued the credential.

statusstring

Lifecycle status after the call.

status_idxinteger

Status-list index assigned to the credential.

issued_atstring date-time

Timestamp when the credential was issued.

expires_atstring date-time

Timestamp when the credential expires.

source_session_idstring

Source Didit verification session identifier. The captured record uses an empty string when no source session is linked.

Example response

{
  "uuid": "227e2acd-2d34-407a-8583-9b3fe2f71c61",
  "vct": "AirlineLoyalty",
  "iss": "http://localhost:8011/v1/issuers/docs-capture-6clew6",
  "status": "revoked",
  "status_idx": 36,
  "issued_at": "2026-07-02T23:33:33.604754Z",
  "expires_at": "2027-07-02T23:33:33.604455Z",
  "holder_cnf": {
    "crv": "P-256",
    "kty": "EC",
    "x": "IH7dt6boywBE90Bl9MkN2Gu4PkSmX4EyA73B-eo51j0",
    "y": "hJbByecLuaOCmC02m5kx_Y1DuK23tkMBRJolu1f-3EI"
  }
}