MATTR Learn

Create a Status List Signers

POST/v2/credentials/mobile/status-list-signers

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

iacaId*string

Internal identifier of the IACA used to sign this status list signer:

Must be the same IACA used to sign credentials that are included in a status list signed by this status list signer.
Must be an unmanaged (external) IACA.

Formatuuid

Response Body

`application/json`

curl -X POST "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-list-signers" \  -H "Content-Type: application/json" \  -d '{    "iacaId": "080c670a-2e90-4023-b79f-b706e55e9bc6"  }'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "iacaId": "080c670a-2e90-4023-b79f-b706e55e9bc6",
  "active": false,
  "csrPem": "-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE REQUEST-----"
}

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

Revoke a Status List Signer

POST/v2/credentials/mobile/status-list-signers/{statusListSignerId}/revoke

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

statusListSignerId*string

Status list signer identifier

Formatuuid

Request Body

application/json

Empty request body for status list signer revocation

Response Body

`application/json`

curl -X POST "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-list-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08/revoke" \  -H "Content-Type: application/json" \  -d '{}'

{
  "revoked": true,
  "revocationDate": "2025-10-31T23:59:59Z"
}

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

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

Retrieve all Status List Signers

GET/v2/credentials/mobile/status-list-signers

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Response Body

`application/json`

curl -X GET "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-list-signers"

{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "iacaId": "080c670a-2e90-4023-b79f-b706e55e9bc6",
      "active": false,
      "csrPem": "-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE REQUEST-----"
    }
  ]
}

Retrieve a Status List Signer

GET/v2/credentials/mobile/status-list-signers/{statusListSignerId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

statusListSignerId*string

Status list identifier

Formatuuid

Response Body

`application/json`

curl -X GET "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-list-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "iacaId": "080c670a-2e90-4023-b79f-b706e55e9bc6",
  "active": false,
  "csrPem": "-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE REQUEST-----"
}

Update a Status List Signer

PUT/v2/credentials/mobile/status-list-signers/{statusListSignerId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

statusListSignerId*string

Status list identifier

Formatuuid

Request Body

application/json

active?boolean

Status list signer status. Must be set to true for this status list signer to be available for signing status lists.

certificatePem?string

Status list signer certificate in PEM format. The certificate must be:

Valid
Not expired
Compliant with the details provided in the Certificate Signing Request returned when the status list signer was created

Response Body

`application/json`

curl -X PUT "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-list-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "iacaId": "080c670a-2e90-4023-b79f-b706e55e9bc6",
  "active": true,
  "certificatePem": "string",
  "certificateFingerprint": "475DA948E4BA44D9B5BC31AB4B8006113FD5F538",
  "certificateData": {
    "notBefore": "2019-08-24T14:15:22Z",
    "notAfter": "2019-08-24T14:15:22Z",
    "country": "string",
    "stateOrProvinceName": "string",
    "organisationName": "string"
  }
}

Delete a Status List Signer

DELETE/v2/credentials/mobile/status-list-signers/{statusListSignerId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

statusListSignerId*string

Status list identifier

Formatuuid

Response Body

curl -X DELETE "https://example.vii.au01.mattr.global/v2/credentials/mobile/status-list-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08"

Empty

Status List Signers

200application/json

409application/json

200application/json

400application/json

404application/json

409application/json

200application/json

200application/json

200application/json

204

On this page

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`