Skip to main content

List presentation definition

GET 
/v2/config/digital-wallet/openid/sdjwt/presentation-definitions

Lists all presentation definitions configured for OpenID4VP verification.

Request​

Query Parameters

    offset integerrequired

    Number of records to skip for pagination.

    limit integerrequired

    Default value: 10

    Maximum number of records to return per page.

    search stringrequired

    Search term to filter results by

    sortOrder stringrequired

    Possible values: [desc, asc]

    Default value: desc

    Sort order for the returned records (ascending or descending).

Responses​

Presentation definitions listed successfully

Response Headers
    Schema
      presentationDefinition object[]
    • Array [
      • presentationDefinitionId stringrequired

      Unique identifier assigned to the presentation definition upon creation. Use this ID when sending verification requests.

      label stringrequired

      Human-readable label describing the purpose of this presentation definition (e.g. 'Verify Portable Document A1'). Used to identify the presentation definition in the verifier's dashboard.

      presentationDefinition objectrequired

      JSON object defining the credential requirements for verification, following the DIF Presentation Exchange specification. Specifies which credential types and claims the verifier requires from the holder. Reference: https://identity.foundation/presentation-exchange/

      property name* any

      JSON object defining the credential requirements for verification, following the DIF Presentation Exchange specification. Specifies which credential types and claims the verifier requires from the holder. Reference: https://identity.foundation/presentation-exchange/

      transactionDataDefinitionType string

      Possible values: [payment_data]

      Type of transaction data to bind to the verification request. payment_data enables payment confirmation flows where the holder must confirm transaction details before presenting credentials.

      enforceWUA boolean

      When true, the verifier requires the holder to present a valid Wallet Unit Attestation (WUA) alongside the Verifiable Presentation, as defined in the EUDI Wallet Architecture Reference Framework.

      createdAt numberrequired

      Unix timestamp (in seconds) when this presentation definition was created.

      updatedAt numberrequired

      Unix timestamp (in seconds) when this presentation definition was last modified.

      version string

      Possible values: [draft_14, draft_18, draft_23, version_01]

      OpenID for Verifiable Presentation (OpenID4VP) specification draft version to use for verification protocol interactions. Determines the Authorization Request format and supported features.

      kid string

      Key Identifier (kid) referencing the cryptographic key used by the verifier for signing the Authorization Request or for response encryption.

      trustAnchor string

      Possible values: [jwk, did:key, did:ebsi, did:web, did:tdw]

      DID method or key type used as the verifier's trust anchor. Determines how the verifier's identity is published and resolved by holders.

      scope string

      OAuth 2.0 scope value for scope-based credential presentation requests.

      responseType string

      Possible values: [id_token, vp_token]

      OAuth 2.0 response type for the OpenID4VP Authorization Request. vp_token requests a Verifiable Presentation. id_token requests an OpenID Connect ID Token.

      dcqlQuery object

      Digital Credentials Query Language (DCQL) query object defining the credentials and claims requested from the holder. DCQL is an alternative to DIF Presentation Exchange for specifying credential requirements in OpenID4VP.

      property name* any

      Digital Credentials Query Language (DCQL) query object defining the credentials and claims requested from the holder. DCQL is an alternative to DIF Presentation Exchange for specifying credential requirements in OpenID4VP.

      clientIdScheme string

      Possible values: [redirect_uri, did, verifier_attestation, x509_san_dns, x509_hash]

      Client ID scheme used by the verifier in the OpenID4VP Authorization Request. Determines how the verifier identifies itself to the holder's wallet. redirect_uri uses a redirect URI, did uses a DID, verifier_attestation uses a Verifier Attestation JWT, x509_san_dns uses an X.509 certificate SAN DNS name, x509_hash uses an X.509 certificate hash.

      directPostRedirectUri string

      URI that the holder's wallet redirects to after posting the Authorization Response via direct_post response mode. Used to return the user to the verifier's application.

      responseMode string

      Possible values: [direct_post, direct_post.jwt]

      OpenID4VP response mode specifying how the holder's wallet delivers the Authorization Response. direct_post sends the response via HTTP POST to the verifier's endpoint. direct_post.jwt sends the response as an encrypted JWT via HTTP POST.

      encryptedResponseEncValuesSupported string[]

      Possible values: [A128CBC-HS256, A128GCM, A256GCM]

      Array of JWE content encryption algorithms supported by the verifier for encrypting the OpenID4VP Authorization Response.

    • ]
      • pagination object
      currentPage integer

      Current page number

      totalItems integer

      Total number of items available

      totalPages integer

      Total number of pages based on limit

      limit integer

      Number of items per page

      hasPrevious boolean

      Indicates if there's a previous page

      hasNext boolean

      Indicates if there's a next page

    Loading...
    Last updated on