MATTR VII Platform API

🪪 CREDENTIAL ISSUANCE

Establishing Trust

OID4VCI

Direct Issuance

mDocs Management

CWT Credentials Management

JSON Credentials Management

📱 CREDENTIAL HOLDING

Create a holder application POST Retrieve all holder applications GET Retrieve a holder application GET Update a holder application PUT Delete a holder application DELETE Retrieve all registered holder application instances GET Retrieve a registered holder application instance GET Delete a registered holder application instance DELETE

✅ CREDENTIAL VERIFICATION

Establishing Trust

mDocs Verification

CWT Credentials Verification

JSON Credentials Verification

🌐 TRUST NETWORKS

Establishing Trust

Ecosystem

Participants

Policies

VICAL

RICAL

⚙️ PLATFORM MANAGEMENT

General

Configuration

MATTR VII Management API

API ReferenceHolder applications

Retrieve a registered holder application instance

Roles

adminholder

Analytics Events

CREDENTIAL_HOLDER_APPLICATION_INSTANCE_RETRIEVE_STARTCREDENTIAL_HOLDER_APPLICATION_INSTANCE_RETRIEVE_SUCCESSCREDENTIAL_HOLDER_APPLICATION_INSTANCE_RETRIEVE_FAIL

GET/v1/holder/applications/{holderApplicationId}/instances/{instanceId}

Retrieves a registered instance of a holder application.

Analytic events

CREDENTIAL_HOLDER_APPLICATION_INSTANCE_RETRIEVE_START
CREDENTIAL_HOLDER_APPLICATION_INSTANCE_RETRIEVE_SUCCESS
CREDENTIAL_HOLDER_APPLICATION_INSTANCE_RETRIEVE_FAIL

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

holderApplicationId*string

Unique identifier for a registered holder application.

Formatuuid

instanceId*string

Unique identifier for an instance of a registered holder application.

Formatuuid

Response Body

`application/json`

`application/json`

curl -X GET "https://example.com/v1/holder/applications/497f6eca-6276-4993-bfeb-53cbbbba6f08/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{  "id": "string",  "appAttestationType": "none",  "registeredAt": "2019-08-24T14:15:22Z",  "licenseExpiresAt": "2019-08-24T14:15:22Z",  "lastAttestedAt": "2019-08-24T14:15:22Z",  "externalReferenceId": "string",  "deviceDetails": {    "deviceModel": "string",    "deviceMake": "string",    "osVersion": "string"  },  "sdkDetails": {    "sdkVersion": "string"  }}

How would you rate this page?

Retrieve all registered holder application instances GET

Retrieves all registered instances of a holder application. This can be used by application owners to view all registered instances for a given holder application. ### **Analytic events** * CREDENTIAL_HOLDER_APPLICATION_INSTANCE_RETRIEVE_LIST_START * CREDENTIAL_HOLDER_APPLICATION_INSTANCE_RETRIEVE_LIST_SUCCESS * CREDENTIAL_HOLDER_APPLICATION_INSTANCE_RETRIEVE_LIST_FAIL

Delete a registered holder application instance DELETE

Deletes a registered instance of a holder application. Deleted instances will no longer be able to interact with the platform or receive tokens, and any existing tokens will be revoked. Application owners can use this endpoint to remove individual instances that are no longer needed or were registered by mistake, without affecting the entire holder application or its other instances. This is useful for cleaning up test instances or managing specific devices, rather than deleting the whole application and all its associated instances. ### **Analytic events** * CREDENTIAL_HOLDER_APPLICATION_INSTANCE_DELETE_START * CREDENTIAL_HOLDER_APPLICATION_INSTANCE_DELETE_SUCCESS * CREDENTIAL_HOLDER_APPLICATION_INSTANCE_DELETE_FAIL