Retrieve all credential bundles for a credential reference
Retrieve all credential bundles associated with the specified credential reference. A credential bundle is one credential, for one credential type and claim set, as it sits in one wallet instance. It can hold several instances of that credential, such as the new versions issued by each update.
Roles
Analytics Events
bearerAuthAuthorizationBearer <token>credentialReferenceId*stringThe credential reference ID represents a link between a user and a credential profile, and is used to manage credentials for the user. Each credential reference ID is unique to a combination of user, credential type and, when the credential is issued against a claim set, claim set identifier. It stays the same across every device the credential is claimed on and every time the credential is updated, and is returned in the response when retrieving credential references.
uuidlimit?numberRange size of returned list.
1 <= value <= 1000100cursor?stringStarting point for the list of entries.
Credential bundles retrieved
application/json- response
data?array<>nextCursor?stringcurl -X GET 'https://example.vii.au01.mattr.global/v1/users/credential-references/a248d6c9-3f5e-4b2a-9c1e-2f3b4c5d6e7f/credential-bundles'{ "data": [ { "userId": "41458e5a-9092-40b7-9a26-d4eb43c5792f", "id": "e123f4a5-6b7c-8901-2345-67890abcdef2", "issuanceProtocol": "openid4vci", "credentialReferenceId": "a248d6c9-3f5e-4b2a-9c1e-2f3b4c5d6e7f", "credentialConfigurationId": "b123c4d5-6e7f-8901-2345-67890abcdef1", "credentialProfile": "mobile", "credentialType": "org.iso.18013.5.1.mDL", "sessionId": "string", "walletId": "com.example.wallet", "walletInstanceId": "d654c3b2-1a0f-9e8d-7c6b5a4f3e2d", "offerId": "f567e8d9-0a1b-2345-6789-0abcdef12345", "claimSetId": "claim-set-1", "state": "active" } ], "nextCursor": "string"}How would you rate this page?
Retrieve a credential reference GET
Retrieve the specified credential reference. A credential reference is a logical identifier for a credential, independent of any particular wallet or device. When a credential is issued to a user, it may be stored in multiple wallets or on multiple devices. Each stored instance is a separate copy, but all copies represent the same underlying credential. The credential reference stays the same across all of these instances, allowing issuers to consistently identify and interact with the credential regardless of where the user holds it.
Search credential bundles POST
Search across every credential bundle issued from your tenant, optionally filtered by claim set identifier and/or state. Unlike the other credential bundle endpoints, this search is not scoped to a single user or credential reference. When `state` is omitted, only `active` bundles are returned. Claim set identifiers are offered as an **open beta preview** feature and are not generally available yet. They are available on all tenants, and their behavior may change in a way that breaks existing integrations before they become generally available.