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.

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"
    }
  ]
}