Retrieve a Status list token

Retrieves the Status list token in CWT format. This public endpoint returns a token which contains a compressed, signed list of credential statuses. Relying parties can use this token to check the revocation status of an mDoc that references this Status list.

This endpoint is intended for public consumption, and as such does not require authentication.

Token Format Differences:

The token structure depends on the Status List configuration format:

Draft 14 of the IETF Token Status List specification:

• Token header typ: application/statuslist+cwt
• CBOR payload claims: 65533 (status_list), 65534 (ttl)
• Status encoding: 1-bit (Valid/Invalid)

Legacy format:

• Token header typ: mattr-statuslist+cwt
• CBOR payload claims: -65538 (status_list), -65539 (ttl)
• Status encoding: 2-bit (Valid/Invalid/Suspended)

Analytic events

• MOBILE_CREDENTIAL_STATUS_LIST_TOKEN_RETRIEVE_START
• MOBILE_CREDENTIAL_STATUS_LIST_TOKEN_RETRIEVE_SUCCESS
• MOBILE_CREDENTIAL_STATUS_LIST_TOKEN_RETRIEVE_FAIL

Path Parameters

Response Body

curl -X GET "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-lists/497f6eca-6276-4993-bfeb-53cbbbba6f08/token"

"string"

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}