List credential definition
GET/v2/config/digital-wallet/openid/sdjwt/credential-definitions
Lists all credential definitions configured for OID4VCI credential issuance, with the newest change first. Each entry also holds the issuance counts of the credential definition, and the response holds the aggregate issuance counts of the organisation. search matches the label and the credential definition ID. sortOrder sorts on the last modification time. vct, doctype and type match the value at the top level of a record and in its credential configurations.
Request
Query Parameters
Default value: 0
Number of records to skip for pagination. A negative or unreadable value falls back to 0.
Default value: 10
Maximum number of records to return per page.
Filter by IETF SD-JWT VC verifiable credential type identifier.
Filter by ISO 18013-5 mDoc/mDL document type identifier.
Filter by W3C Verifiable Credential type (JWT format).
Search term to filter results by
Possible values: [desc, asc]
Default value: desc
Sort order for the returned records (ascending or descending).
Default value: false
When true, the server does not calculate the issuance counts. Use this option for a faster response. The server then returns zero in totalCountOfCredentialHistory and in each issuanceBreakdown field.
Responses
- 200
- 400
- 401
- 500
Credential definitions listed successfully
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
Credential definitions for the current page, sorted by the last modification time. The value is null or an empty array when the page holds no record.
pagination object
Current page number
Total number of items available
Total number of pages based on limit
Number of items per page
Indicates if there's a previous page
Indicates if there's a next page
issuanceHistoryStats object
Aggregate issuance counts for the whole organisation. The filters and the pagination do not change these counts.
Total number of credential exchange records.
Number of records that the holder accepted and that are not revoked.
Number of records that are still in progress.
Number of records whose credential is revoked.
Number of records for which the issuer denied the issuance.
{
"credentialDefinition": [
{
"id": "9f1c2a34-5b6d-4e7f-8a90-1b2c3d4e5f60",
"credentialDefinitionId": "9f1c2a34-5b6d-4e7f-8a90-1b2c3d4e5f60",
"openIdOrganisationId": "string",
"createdAt": 1750000000,
"updatedAt": 1750000600,
"label": "Issue Portable Document A1",
"credentialDefinitions": [
{
"id": "string",
"credentialConfigurationId": "string",
"label": "string",
"expirationInDays": 0,
"expirationInSeconds": 0,
"supportRevocation": true,
"revocationMethod": "status_list",
"statusListCryptographicKeyFormat": "x509",
"statusListCryptographicKeyIdentifier": "string",
"enforceCredentialUniqueness": true,
"supportCredentialReissuance": true,
"credentialBindingMethods": [
"did:key"
],
"authorizationRequestType": "authorization_details",
"scope": "string",
"display": {
"name": "string",
"locale": "en-GB",
"description": "string",
"backgroundColor": "string",
"textColor": "string",
"logo": {
"uri": "string",
"altText": "string"
},
"backgroundImage": {
"uri": "string"
}
},
"credentialResponseInterval": 0,
"credentialFormat": "jwt_vc_json",
"validationPath": "string",
"type": [
"string"
],
"vct": "string",
"doctype": "string",
"credentialDefinitionUri": "string",
"cryptographicKeyFormat": "x509",
"cryptographicKeyIdentifier": "string",
"credentialCategory": "eaa",
"signingKeyCheck": {
"result": "fits",
"messages": []
},
"suggestedCredentialCategory": null,
"supportAttestationProof": true,
"supportJwtProof": true,
"enforceKeyAttestation": true,
"keyAttestationsRequired": {
"attestation": {
"key_storage": [
"iso_18045_basic"
],
"user_authentication": [
"iso_18045_basic"
]
},
"jwt": {
"key_storage": [
"iso_18045_basic"
],
"user_authentication": [
"iso_18045_basic"
]
}
},
"claims": {
"claims": [
{
"path": [
"address",
"country"
],
"mandatory": true,
"limitDisclosure": true
}
]
},
"credentialDefinition": {
"claims": [
{
"path": [
"credentialSubject",
"identifier"
],
"mandatory": true
}
]
}
}
],
"version": "version_01",
"cryptographicKeyFormat": "x509",
"cryptographicKeyIdentifier": "string",
"trustAnchor": "string",
"kid": "string",
"enforceWUA": true,
"supportInteractiveAuthorisationEndpoint": true,
"supportWalletInitiatedIssuance": true,
"supportCredentialOfferReuse": true,
"oidcProviderId": "string",
"systemManaged": true,
"extensionEnabled": true,
"display": {
"name": "Legal Person Identification Data",
"locale": "en-GB",
"description": "string",
"backgroundColor": "#FFFFFF",
"textColor": "#000000",
"logo": {
"uri": "string",
"altText": "string"
},
"backgroundImage": {
"uri": "string"
}
},
"expirationInDays": 180,
"expirationInSeconds": 0,
"supportRevocation": true,
"revocationMethod": "status_list",
"enforceCredentialUniqueness": true,
"supportCredentialReissuance": true,
"credentialBindingMethods": [
"did:key"
],
"credentialFormat": "jwt_vc_json",
"validationPath": "string",
"type": [
"string"
],
"vct": "urn:eu.europa.ec.eudi:pid:1",
"doctype": "eu.europa.ec.eudi.pid.1",
"namespace": "string",
"credentialDefinitionUri": "string",
"claims": {
"claims": [
{
"path": [
"address",
"country"
],
"mandatory": true,
"limitDisclosure": true
}
]
},
"supportJwtProof": true,
"supportAttestationProof": true,
"enforceKeyAttestation": true,
"credentialDefinition": {
"claims": [
{
"path": [
"credentialSubject",
"identifier"
],
"mandatory": true
}
]
},
"totalCountOfCredentialHistory": 42,
"issuanceBreakdown": {
"total": 42,
"accepted": 30,
"inProgress": 7,
"revoked": 3,
"denied": 2
}
}
],
"pagination": {
"currentPage": 1,
"totalItems": 25,
"totalPages": 3,
"limit": 10,
"hasPrevious": false,
"hasNext": true
},
"issuanceHistoryStats": {
"total": 120,
"accepted": 84,
"inProgress": 21,
"revoked": 9,
"denied": 6
}
}
The organisation is unknown or the wallet is not deployed.
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
{
"errorCode": 400,
"errorDescription": "Bad input parameter"
}
Unauthorized
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
{
"errorCode": 400,
"errorDescription": "Bad input parameter"
}
Internal server error
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
{
"errorCode": 400,
"errorDescription": "Bad input parameter"
}