You can use MATTR VII to change the status of issued Compact Credentials if you ever need to revoke them for any reason. Verifiers can obtain the revocation status of presented credentials in a way that preserves holders’ privacy.

A revocable Compact Credential points to a revocation list which is managed by the credential`s issuer. The list contains the revocation status of many credentials, and the credential references the index of its status within a specific revocation list.

Revocation lists are automatically created and managed when you use your MATTR VII tenant to issue revocable credentials. They are publicly available and mainly consumed by external verifiers.

When a verifier requests a revocation list, the issuer cannot tell what credential they are checking the status for. This means the issuer does not know how often or to whom a credential is being presented, maintaining holder`s privacy.

credentialStatus object

When a Compact Credential is set as revocable the credentialStatus object is added to the credential:

"status": {
      "index": 4,
      "url": ""
  • index : This indicates the index of this specific credential within the revocation list.
  • url : Every revocable credential will reference a Revocation List that is automatically created and held on the issuer's tenant. This list can be used by external verifiers to validate the credential status. The status.url property references the revocation list which holds the revocation status for this specific credential.

Additional resources


API Reference