Retrieve all credential bundles for a credential reference
/v1/users/credential-references/{credentialReferenceId}/credential-bundlesRetrieve all credential bundles associated with the specified credential reference. A credential bundle represents a group of credentials that were issued together as part of the same issuance session.
Roles
Analytics Events
Authorization
bearerAuth In: header
Path Parameters
The credential reference ID represents a link between a user and a credential profile, and is used to manage credentials for the user. The credential reference ID is generated by the system when a credential reference is created, and is returned in the response when retrieving credential references.
uuidQuery Parameters
Range size of returned list.
1 <= value <= 1000100Starting point for the list of entries.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/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 a **closed beta preview** feature and are not generally available yet. They are enabled per tenant, and their behavior may change in a way that breaks existing integrations. If you are interested in trying this feature, please [contact us](mailto:dev-support@mattr.global).