Skip to main content
Presentation definitions

Create presentation definition

POST/v4/config/ows/verifier/presentation-definitions

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:

SettingDefault and effect
responseModedirect_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, cryptographicKeyIdentifierThe 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.
credentialQueryOptionsNo trust rule: no check runs, and the verifier accepts any issuer.
transactionDataDefinitionTypeNo 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

  • Authorizationstringheaderrequired

    Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.

    Scope:presentation-definitions:create

Body

application/json

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.

One of
  • bodyobject

Response

application/json

The new presentation definition.

  • signingKeyWarningsstring[]

    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.

  • presentationDefinitionobject

    A 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.