Create presentation definition
Creates a presentation definition: the credentials and claims that the verifier asks for, as a DCQL query, and the transport settings that each of its verification requests uses. Then send a request with Send verification request.
Send label, version and dcqlQuery. The other settings have defaults:
| Setting | Default and effect |
|---|---|
responseMode | direct_post: the wallet posts the response to the verifier. With dc_api or dc_api.jwt, the browser gets the response over the Digital Credentials API, and your frontend forwards it with Receive DC API verification response. |
clientIdScheme, cryptographicKeyFormat, cryptographicKeyIdentifier | The default key of the organisation signs the request: x509_hash for a key with a certificate chain, else did. redirect_uri outside the DC API gives an unsigned request. |
credentialQueryOptions | No trust rule: no check runs, and the verifier accepts any issuer. |
transactionDataDefinitionType | No transaction data. Required when the query asks for a Payment Wallet Attestation, a QESAC or an SCA attestation. |
The server checks the settings together, and the field descriptions give each rule. For example, direct_post.jwt needs encryptedResponseEncValuesSupported and isCredentialEncryptionEnabled in the verifier configuration, a signed DC API request needs expectedOrigins, and an etsi_tl value of trusted_authorities must be the URL of an ETSI list trust source of the organisation. label and scope must be unique in the organisation.
iso18013_7_annex_c has more rules: responseType device_response, an x509 key, no clientIdScheme, no transactionDataDefinitionType, exactly one value in expectedOrigins, and only mso_mdoc credential queries with meta.doctype_value, a non-empty claims array of two-element paths and require_cryptographic_holder_binding true, without credential_sets or claim_sets.
Authorizations
AuthorizationstringheaderrequiredYour API key with the prefix
ApiKey:ApiKey <your-api-key>. Get an API key.Scope:
presentation-definitions:create
Body
The presentation definition to create. A member that the operation does not declare is refused (<name>: unknown field), also the removed names trustAnchor and kid.
bodyobject
Response
The new presentation definition.
signingKey Warnings string[]The warnings of the signing key, for a key whose certificate preset this use does not accept (also a key with no certificate preset): one text for each rule of this use that its certificate does not fit. Always present; an empty list when there is no warning. The save is not refused.
presentationDefinition objectA presentation definition: the DCQL query of a verifier and the transport settings that each of its verification requests uses. A member without a value is left out, except the required members.