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
/v2/credentials/mobile/status-lists/configurations
In: header
The Status list configuration payload
Status list configurations are unique per docType on your tenant. This value must match the type set when creating an mDoc credential configuration.
1 <= length <= 1024
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
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
/v2/credentials/mobile/status-lists/configurations
In: header
Query Parameters
Range size of returned list.
100
1 <= value <= 1000
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
/v2/credentials/mobile/status-lists/configurations/{id}
In: header
Path Parameters
Status list configuration ID
uuid
Status list configuration ID
uuid
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
/v2/credentials/mobile/status-lists/configurations/{id}
In: header
Path Parameters
Status list configuration ID
uuid
Status list configuration ID
uuid
The Status list configuration payload
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
/v2/credentials/mobile/status-lists/configurations/{id}
In: header
Path Parameters
Status list configuration ID
uuid
Status list configuration ID
uuid
curl -X DELETE "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-lists/configurations/3948c40e-6e19-4ffc-933c-91f643f24264"
{
"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?