Retrieve a credential reference
/v1/users/credential-references/{credentialReferenceId}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.
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.
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/users/credential-references/a248d6c9-3f5e-4b2a-9c1e-2f3b4c5d6e7f"{ "userId": "41458e5a-9092-40b7-9a26-d4eb43c5792f", "credentialReferenceId": "a248d6c9-3f5e-4b2a-9c1e-2f3b4c5d6e7f", "credentialProfile": "mobile", "credentialType": "org.iso.18013.5.1.mDL", "claimSetId": "claim-set-1"}How would you rate this page?
Retrieve all credential references GET
Retrieve all credential references associated with the specified user. 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.
Retrieve all credential bundles for a credential reference GET
Retrieve 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.