Status list distribution
/v2/credentials/mobile/status-lists/distributionRetrieves an object that details all existing Status lists tokens on the tenant. This public endpoint allows a relying party to consume and cache status lists. Each list in the response includes a URL where its token can be retrieved. Status list tokens that were signed by expired IACAs are excluded from the response.
This endpoint is intended for public consumption, and as such does not require authentication.
Response Format:
MATTR VII implements Draft 14 of the IETF Token Status List specification, so
status_lists is an array of URL strings: {"status_lists": ["https://..."]}
Tenants that issued credentials before adopting Draft 14 also serve those Status
lists in the earlier format, where status_lists is an array of objects:
{"status_lists": [{"uri": "https://..."}]}. Relying parties should handle both
shapes.
Analytics Events
Response Body
application/json
curl -X GET "https://example.com/v2/credentials/mobile/status-lists/distribution"{ "status_lists": [ "https://learn.vii.au01.mattr.global/v2/credentials/mobile/status-lists/{statusListId}/token" ]}How would you rate this page?
Retrieve a Status list token GET
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**: MATTR VII implements 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)
Update mDoc status POST
Sets the status of an existing mDoc by providing its `credentialId` and the new status. MATTR VII implements Draft 14 of the IETF Token Status List specification, which uses 1-bit encoding. The available status values are: * **valid** - Credential is valid * **invalid** - Credential is invalid (cannot be reversed)