List presentation definition
GET/v2/config/digital-wallet/openid/sdjwt/presentation-definitions
Lists the presentation definitions of the organisation. The server sorts them by updatedAt and uses sortOrder for the direction.
Each item holds the presentation definition and the verification counters for that presentation definition. In this list the id of each item equals its presentationDefinitionId.
The response also holds verificationHistoryStats. These counters cover every verification exchange record of the organisation, not only the current page.
Set skipCounts to true to skip the per item counters. The server then returns zero for every counter of every item, and the answer is faster.
search finds a presentation definition by its label or by its presentationDefinitionId. The search is not case-sensitive.
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.
Search term to filter results by
Possible values: [desc, asc]
Default value: desc
Sort order for the returned records (ascending or descending).
Possible values: [payment_data, payment, login_risk_transaction, login_risk_transaction_non_ts12, account_access, emandate, data_agreement_record, data_disclosure_agreement_record, qes_data]
Filter by the transaction data type of the presentation definition. The server compares this value with transactionDataDefinitionType.
Default value: false
Set to true to skip the per item verification counters. Every counter of every item is then zero. Use this option for a faster answer.
Responses
- 200
- 400
- 401
- 500
The server listed the presentation definitions.
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
Presentation definitions for the current page. The array is empty when the organisation has no presentation definition.
pagination objectrequired
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
verificationHistoryStats objectrequired
Counters for every verification exchange record of the organisation. The filters and the pagination do not change these values. A record can be in more than one counter, so the counters do not add up to total.
Number of verification exchange records.
Number of records with status presentation_acked.
Number of records with status request_sent or request_received.
Number of records with status presentation_acked and verified equal to false.
Always 0.
{
"presentationDefinition": [
{
"id": "string",
"openIdOrganisationId": "string",
"presentationDefinitionId": "string",
"label": "string",
"dcqlQuery": {},
"transactionDataDefinitionType": "",
"createdAt": 0,
"updatedAt": 0,
"version": "version_01",
"cryptographicKeyIdentifier": "string",
"cryptographicKeyFormat": "did:key",
"scope": "string",
"responseType": "vp_token",
"clientIdScheme": "redirect_uri",
"directPostRedirectUri": "string",
"responseMode": "direct_post",
"dcApiRequestType": "signed",
"expectedOrigins": [
"string"
],
"encryptedResponseEncValuesSupported": [
"A128CBC-HS256"
],
"systemManaged": true,
"extentionEnabled": true,
"presentationDefinition": {},
"transactionDataCredentialIds": [
"string"
],
"excludeVerifierDisplayMetadata": true,
"totalCountOfVerificationHistory": 42,
"verificationBreakdown": {
"total": 42,
"presentationReceived": 30,
"requestPending": 9,
"verificationFailed": 3,
"expired": 0
}
}
],
"pagination": {
"currentPage": 1,
"totalItems": 25,
"totalPages": 3,
"limit": 10,
"hasPrevious": false,
"hasNext": true
},
"verificationHistoryStats": {
"total": 128,
"presentationReceived": 96,
"requestPending": 24,
"verificationFailed": 5,
"expired": 0
}
}
The organisation has no deployed digital wallet.
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"
}
The server could not read the page of presentation definitions.
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
{
"errorCode": 400,
"errorDescription": "Bad input parameter"
}