Presentation Configuration
Fields of a presentation configuration, as accepted by POST /api/verifier/config and in config/<tenant>/presentation/<id>.json. PATCH /api/verifier/config/{id} accepts the same fields, all optional. For the task-oriented guide see Configure Verification.
Fields
The table is generated at build time from the Zod schema the backend validates with. The schema is strict: unknown fields are rejected. dcql_query.credentials[] has one shape per format (mso_mdoc and dc+sd-jwt).
| Field | Required | Type / allowed values | Description |
|---|---|---|---|
id | yes | string | Presentation configuration identifier. |
description | no | string or null | Optional presentation configuration description. |
lifeTime | no | integer (minimum 1) | Presentation request lifetime in seconds. |
skewSeconds | no | integer (minimum 0) | Clock skew tolerance in seconds. |
statusCheckMode | no | string: strict | best_effort | disabled | Revocation/status check mode. |
dcql_query | yes | object | DCQL query defining requested credentials and claims. |
dcql_query.credentials | yes | array of one of 2 shapes | Credential queries requested by the verifier. |
dcql_query.credentials[].id | yes | string | Credential query identifier. |
dcql_query.credentials[].multiple | no | boolean | Allow multiple matching credentials. |
dcql_query.credentials[].claim_sets | no | array of array of string | Optional claim set constraints. |
dcql_query.credentials[].trusted_authorities | no | array of one of 2 shapes | Optional trusted authority constraints. |
dcql_query.credentials[].trusted_authorities[].type | yes | string: etsi_tl | Only when type is etsi_tl. Trusted authority type discriminator for ETSI trust lists. |
dcql_query.credentials[].trusted_authorities[].values | yes | array of one of 2 shapes | Only when type is etsi_tl. Trust list references for ETSI TL verification. |
dcql_query.credentials[].trusted_authorities[].values[].format | yes | string: trusted-list | Only when format is trusted-list. Format of the list: an ETSI TS 119 612 Trusted List or list of trusted lists as XML. |
dcql_query.credentials[].trusted_authorities[].values[].url | yes | string | Only when format is trusted-list. URL of the Trusted List, or of a list of trusted lists (LOTL) whose national lists are followed. |
dcql_query.credentials[].trusted_authorities[].values[].signingCertificates | yes | array of string | Only when format is trusted-list. Base64 DER certificates one of which must have signed the list: for a list of trusted lists, the signing certificates its operator publishes; for a national list, its scheme operator certificates. |
dcql_query.credentials[].trusted_authorities[].values[].schemeTerritories | no | array of string | Only when format is trusted-list. For a list of trusted lists: the SchemeTerritory values of the national lists to follow, such as DE. All when absent. |
dcql_query.credentials[].trusted_authorities[].values[].format | no | string: lote | Only when format is lote. Format of the list: a List of Trusted Entities (ETSI TS 119 602) as JWT. Default. |
dcql_query.credentials[].trusted_authorities[].values[].trustListId | no | string | Only when format is lote. Optional trust list id reference. |
dcql_query.credentials[].trusted_authorities[].values[].url | no | string | Only when format is lote. Optional trust list URL reference. |
dcql_query.credentials[].trusted_authorities[].values[].verifierKey | no | object | Only when format is lote. Optional verifier key material. |
dcql_query.credentials[].trusted_authorities[].values[].verifierX509Der | no | string | Only when format is lote. Optional verifier certificate in DER/base64 form. |
dcql_query.credentials[].trusted_authorities[].type | yes | string: openid_federation | Only when type is openid_federation. Trusted authority type discriminator for OpenID Federation. |
dcql_query.credentials[].trusted_authorities[].values | yes | array of string | Only when type is openid_federation. OpenID Federation authority identifiers. |
dcql_query.credentials[].format | yes | string: mso_mdoc | Only when format is mso_mdoc. Credential format discriminator. |
dcql_query.credentials[].meta | yes | object | Only when format is mso_mdoc. |
dcql_query.credentials[].meta.doctype_value | yes | string | Only when format is mso_mdoc. Expected mDoc doctype value. |
dcql_query.credentials[].claims | no | array of object | Only when format is mso_mdoc. Optional mDoc claim-level constraints. |
dcql_query.credentials[].claims[].id | no | string | Only when format is mso_mdoc. Optional claim query id. |
dcql_query.credentials[].claims[].path | yes | array of string | number | Only when format is mso_mdoc. Path to the claim value in presented credentials. |
dcql_query.credentials[].claims[].values | no | array of one of 3 shapes | Only when format is mso_mdoc. Optional allowed values for the claim. A disclosed value must equal one of them in type and value. |
dcql_query.credentials[].claims[].intent_to_retain | no | boolean | Only when format is mso_mdoc. Whether relying party intends to retain the claim. |
dcql_query.credentials[].format | yes | string: dc+sd-jwt | Only when format is dc+sd-jwt. Credential format discriminator. |
dcql_query.credentials[].meta | yes | object | Only when format is dc+sd-jwt. |
dcql_query.credentials[].meta.vct_values | yes | array of string | Only when format is dc+sd-jwt. Accepted VCT values. |
dcql_query.credentials[].claims | no | array of object | Only when format is dc+sd-jwt. Optional claim-level constraints. |
dcql_query.credentials[].claims[].id | no | string | Only when format is dc+sd-jwt. Optional claim query id. |
dcql_query.credentials[].claims[].path | yes | array of string | number | Only when format is dc+sd-jwt. Path to the claim value in presented credentials. |
dcql_query.credentials[].claims[].values | no | array of one of 3 shapes | Only when format is dc+sd-jwt. Optional allowed values for the claim. A disclosed value must equal one of them in type and value. |
dcql_query.credential_sets | no | array of object | Optional higher-level credential set requirements. |
dcql_query.credential_sets[].options | yes | array of array of string | Alternative credential query id combinations. |
dcql_query.credential_sets[].required | no | boolean | Whether this credential set is mandatory. |
transaction_data | no | array of object or null | Optional transaction data descriptors. |
transaction_data[].type | yes | string | Transaction data type identifier. |
transaction_data[].credential_ids | yes | array of string | Credential query ids this transaction data applies to. |
transaction_data[].payload | no | any | Transaction details. Required for TS12 SCA transaction data. |
registration_cert | no | object or null | Registration certificate from a registrar, with the purpose and privacy policy it is requested with. |
registration_cert.jwt | no | string | Registration certificate JWT issued by a registrar. Attached to every request object as is; it must be valid and authorize every credential the DCQL query requests. |
registration_cert.purpose | no | array of object | Why the data is requested (GDPR purpose), one text per language. Used when a certificate is requested from a registrar. |
registration_cert.purpose[].lang | yes | string | Language tag of the text, such as en or pt-BR. The EUDI Hub takes two-letter codes only. |
registration_cert.purpose[].content | yes | string | The purpose in that language. |
registration_cert.privacy_policy | no | string | URL of the privacy policy that applies to this request. Used when a certificate is requested from a registrar. |
webhookEndpointId | no | string or null | Optional webhook endpoint id for presentation callbacks. |
attached | no | array of object or null | Optional attachments included with presentation requests. |
attached[].format | yes | string | Attachment format identifier. |
attached[].data | yes | any | Attachment payload. |
attached[].credential_ids | no | array of string | Optional credential query ids bound to this attachment. |
redirectUri | no | string or null | Optional redirect URI after presentation completion. |
accessKeyChainId | no | string or null | Access key chain that signs the request, determines the client_id and signs readerAuth; without it, an access key chain of the tenant is used. |
allowedOrigins | no | array of string or null | Origins (http(s)://host[:port]) of the web pages allowed to request this presentation over the Digital Credentials API. When set, dc-api and iso-18013-7 offers are refused for any other expected_origin, and an offer without expected_origin uses the only listed origin. Unset: any expected_origin is accepted. Not used for uri requests. |
readerAuth | no | boolean or null | Whether reader authentication is required for mDoc requests. |
Defaults and behavior
| Field | Default and behavior |
|---|---|
id | Used as requestId in presentation requests. |
description | Internal only; not shown to the wallet user. |
lifeTime | 300. Seconds until a request created from this configuration expires (expiresAt of the session). |
skewSeconds | 60. Clock skew tolerance for credential time checks; a request can override it. |
statusCheckMode | strict (default): status lists are checked and verification fails if a status list cannot be fetched or validated, or if a credential's status (SD-JWT VC status claim, mDOC MSO status) names only another status mechanism. Credentials without status information are accepted, except a PID whose validity period is longer than 24 hours, which fails with verification_error (ARF Annex 2, VCR_01, VCR_01b and VCR_14). A credential is a PID when its certificate chain matches a certificate listed with a PID/Issuance service in the trust lists (a CA it was issued under, or its own end-entity certificate), also if that certificate is listed with another service as well. Its validity period runs from nbf (else iat) to exp of the SD-JWT VC, where a selectively disclosable iat counts only if the wallet discloses it, or from validFrom to validUntil of the mDOC's MSO; a PID without a start or an end counts as longer than 24 hours. EAAs, Pub-EAAs and QEAAs without status information are left to the relying party's policy and accepted. best_effort: verification continues without the status result when the status list is unavailable, and accepts such a PID with a warning. Both reject a status list that is not ZLIB-compressed or decompresses to more than 16 MiB (SD-JWT VC) or 1 MiB (mDOC). Both fail with verification_error, without fetching a list, on a malformed status reference: an SD-JWT VC status claim that is not a non-empty object, a status_list that is not an object, a uri that is not an absolute URI, or an idx that is not a non-negative integer, and for an mDOC an MSO status that names no mechanism or a status list or identifier list uri that is not an absolute URI. disabled: no status check. Applies to SD-JWT VC and mDOC, including ISO 18013-7. |
dcql_query | See DCQL. <TENANT_URL> anywhere in the query is replaced with <PUBLIC_URL>/issuers/<tenant>. |
transaction_data | Sent with every request unless the request sets its own transaction_data. An ISO 18013-7 request answers 400 unless it sends "transaction_data": []. See Transaction Data. |
registration_cert | jwt (the certificate from a registrar, attached to every request), purpose and privacy_policy (kept for requesting a new one). See Registration Certificates. |
webhookEndpointId | ID of a webhook endpoint that receives results. A request can override it with an inline webhook. |
attached | Stored with the configuration; currently not sent to the wallet. |
redirectUri | Same-device redirect target. {sessionId} is replaced with the session ID. A request can override it, except for ISO 18013-7. See Receive Results. |
accessKeyChainId | Access key chain that signs the request, determines the client_id and signs readerAuth. Without it, EUDIPLO uses the tenant's default access key chain: access of its key chain defaults, else one picked by rule, which prefers a registrar or other CA-issued certificate. |
allowedOrigins | Unset or empty: any expected_origin is accepted. When set, dc-api and iso-18013-7 requests must name one of these origins, or none if exactly one is listed. Not used for uri requests. See Allowed origins. |
readerAuth | false. ISO 18013-7 only: sign the DeviceRequest with the access key chain. Requires the db KMS provider for that key. |
Validation rules
Rules that the table cannot show:
dcql_query.credentialsneeds at least one entry; credential query IDs contain only letters, digits,_and-, and are unique.metais required:vct_values(at least one) fordc+sd-jwt,doctype_valueformso_mdoc.- Every credential query needs
trusted_authoritieswith anetsi_tltrust list or anopenid_federationtrust anchor, unlessSKIP_TRUST_AUTHORITY=true. See DCQL. - Every ID in
claim_setsmust reference theidof a claim in the same credential query; claim IDs are unique. - Each
allowedOriginsentry is an origin in serialized form:httpsorhttpscheme, lower-case host, a port only if it is not the default (443,80), no path, query, credentials or trailing slash. At most 100 entries. transaction_dataentries whosetypestarts withurn:eudi:sca:must be a supported TS12 type with a valid payload.transaction_dataentries must name incredential_idsonlydc+sd-jwtqueries of the DCQL query (Which credentials an entry may reference).
Server-managed fields
Responses also contain createdAt and updatedAt. They are read-only and not part of the schema, so the API rejects them in a request body.