light-mode-image
Learn
API Reference

Status List Configuration

Create a Status 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.

Analytic events

  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_CREATE_START
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_CREATE_SUCCESS
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_CREATE_FAIL
POST/v2/credentials/mobile/status-lists/configurations

Authorization

AuthorizationBearer <token>

In: header

Request Body

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?timeToLiveDuration

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?expiryDuration

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

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

Retrieve all Status List configurations

Retrieve all Status list configurations

Retrieves all Status list configurations from your tenant.

Analytic events

  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_RETRIEVE_LIST_START
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_RETRIEVE_LIST_
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_RETRIEVE_LIST_FAIL
GET/v2/credentials/mobile/status-lists/configurations

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

limit?number

Range size of returned list.

Default100
Range1 <= value <= 1000
cursor?string

Starting point for the list of entries.

curl -X GET "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-lists/configurations?limit=2&cursor=Y3JlYXRlZEF0PTIwMjAtMDgtMjVUMDY6NDY6MDkuNTEwWiZpZD1h"
{
  "nextCursor": "Y3JlYXRlZEF0PTIwMjAtMDgtMjVUMDY6NDY6MDkuNTEwWiZpZD1hNjZmZmVhNS04NDhlLTQzOWQtODBhNC1kZGE1NWY1M2UzNmM",
  "data": [
    {
      "id": "983c0a86-204f-4431-9371-f5a22e506599",
      "docType": "Drivers License",
      "timeToLiveDuration": {
        "days": 1
      },
      "expiryDuration": {
        "days": 2
      }
    }
  ]
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

Retrieve a Status List configuration

Retrieve a Status list configuration

Retrieves an existing Status list configuration by providing its ID.

Analytic events

  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_RETRIEVE_START
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_RETRIEVE_SUCCESS
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_RETRIEVE_FAIL
GET/v2/credentials/mobile/status-lists/configurations/{id}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idstring

Status list configuration ID

Formatuuid
idstring

Status list configuration ID

Formatuuid
curl -X GET "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-lists/configurations/3948c40e-6e19-4ffc-933c-91f643f24264"
{
  "docType": "DriverLicense",
  "timeToLiveDuration": {
    "days": 1
  },
  "expiryDuration": {
    "days": 2
  }
}
{
  "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"
    }
  ]
}

Update a Status List configuration

Update a Status list configuration

Updates an existing Status list configuration, allowing you to adjust the expiry and TTL (Time To Live) settings.

Analytic events

  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_UPDATE_START
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_UPDATE_SUCCESS
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_UPDATE_FAIL
PUT/v2/credentials/mobile/status-lists/configurations/{id}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idstring

Status list configuration ID

Formatuuid
idstring

Status list configuration ID

Formatuuid

Request Body

The Status list configuration payload

bodyStatusListConfigurationUpdateRequest
curl -X PUT "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-lists/configurations/3948c40e-6e19-4ffc-933c-91f643f24264" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "983c0a86-204f-4431-9371-f5a22e506599",
  "docType": "Drivers License",
  "timeToLiveDuration": {
    "days": 1
  },
  "expiryDuration": {
    "days": 2
  }
}
{
  "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"
    }
  ]
}

Delete a Status List configuration

Delete a Status list configuration

Permanently deletes an existing Status list configuration.

Analytic events

  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_DELETE_START
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_DELETE_SUCCESS
  • MOBILE_CREDENTIAL_STATUS_LIST_CONFIGURATION_DELETE_FAIL
DELETE/v2/credentials/mobile/status-lists/configurations/{id}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idstring

Status list configuration ID

Formatuuid
idstring

Status list configuration ID

Formatuuid
curl -X DELETE "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-lists/configurations/3948c40e-6e19-4ffc-933c-91f643f24264"
Empty

{
  "code": "BadRequest",
  "message": "Status list configuration is in use by at least one status list"
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

How would you rate this page?

Tutorial

Previous Page

Status List retrieval

Next Page

On this page

Create a Status List configurationRetrieve all Status List configurationsRetrieve a Status List configurationUpdate a Status List configurationDelete a Status List configuration