v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-05730512.7 KB

OpenID4VP Verification

The signed OpenID4VP request parameters a wallet dereferences (public).

Fetch the public OpenID4VP (OpenID for Verifiable Presentations) request parameters for a wallet. You receive the response mode, response URI, state, nonce, and DCQL (Digital Credentials Query Language) query.

get/v1/presentations/{uuid}/request

Path parameters

uuidstring uuid required

Identifies the presentation request to dereference.

Response

Returns the wallet-facing request parameters.

client_idstring

Identifies the verifier client for the wallet.

response_type'vp_token'

Tells the wallet to return a verifiable presentation token.

response_mode'direct_post'

Tells the wallet to post the response directly to the response URI.

response_uristring uri

Receives the wallet's presentation response.

statestring uuid

Carries the transaction state the wallet returns with the response.

noncestring

Carries the nonce the wallet must bind into the presentation response.

Example response

{
  "client_id": "checkin-rp",
  "response_type": "vp_token",
  "response_mode": "direct_post",
  "response_uri": "http://localhost:8011/v1/presentations/71889d7a-67c1-4ce9-bb73-5e99cd4c0265/response",
  "state": "1aa51264-f2d2-4a97-86b8-940a9c0e1188",
  "nonce": "<redacted>",
  "dcql_query": {
    "credentials": [
      {
        "claims": [
          {
            "path": [
              "<redacted>"
            ]
          }
        ],
        "format": "<redacted>",
        "id": "<redacted>",
        "meta": {
          "vct_values": [
            "<redacted>"
          ]
        }
      }
    ]
  }
}