light-mode-image
Learn
MATTR VII PlatformStatus list configuration

Create a Status list configuration

Creates a Status list configuration, which defines a status list validity periods. mDocs can then be assigned to a specific Status list configuration.

Analytics Events

MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_CREATE_STARTMOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_CREATE_SUCCESSMOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_CREATE_FAIL

Roles

adminissuer
POST/v2/credentials/mobile/status-lists/configurations
AuthorizationBearer <token>

In: header

The Status list configuration payload

docType?string

Status list configurations are unique per docType on your tenant. This value must match the type set when creating an mDoc credential configuration.

Length1 <= length <= 1024
timeToLiveDuration?object

Defines how long relying parties can cache Status list tokens of this docType before it is recommended to retrieve a new Status list token from the tenant. Cannot exceed expiryDuration.

Empty Object

expiryDuration?object

Defines how long relying parties can cache Status list tokens of this docType before they expire. Once a Status list token expires, relying parties can no longer use it to check credentials status and must retrieve a new one from the tenant. Regardless of the value of this parameter, Status list tokens expiry cannot exceed the validity of the IACA that is used to sign the Status list token.

Empty Object

Response Body

curl -X POST "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-lists/configurations" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "983c0a86-204f-4431-9371-f5a22e506599",
  "docType": "Drivers License",
  "timeToLiveDuration": {
    "days": 1
  },
  "expiryDuration": {
    "days": 2
  }
}

{
  "code": "BadRequest",
  "message": "Validation Error",
  "details": [
    {
      "location": "body",
      "msg": "must be a Duration",
      "param": "timeToLiveDuration",
      "value": "abc"
    }
  ]
}

How would you rate this page?