v8

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

OpenID4VP Verification

List the tenant's presentation requests.

List your tenant's OpenID4VP (OpenID for Verifiable Presentations) presentation requests. Use this endpoint to inspect request status, requested claims, and the generated DCQL (Digital Credentials Query Language) query.

get/v1/presentations/requests

Response

Returns a bare JSON array. Each array element is one presentation request.

audstring

Identifies the verifier audience for the presentation.

created_atstring date-time

Records when the presentation request was created.

noncestring

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

purposestring

Explains why the verifier requests the presentation.

requested_claimsstring[]

Lists the claim names the verifier asks the holder to disclose.

requested_vctstring

Names the requested VCT (Verifiable Credential Type).

status'pending' | 'verified' | 'failed'

Shows the current state of the presentation request.

transaction_idstring uuid

Binds the presentation request to the later verification result.

trusted_issstring

Returns the trusted issuer value configured for the request.

uuidstring uuid

Identifies the presentation request.

relying_partystring uuid nullable

You receive the relying party UUID this request is scoped to, or null when it is not scoped to one.

trust_policystring

You receive the effective trust policy for this request: tenant or custom.

Example response

[
  {
    "aud": "checkin-rp",
    "created_at": "2026-07-02T23:51:57.360146Z",
    "dcql": {
      "credentials": [
        {
          "claims": [
            {
              "path": [
                "tier"
              ]
            }
          ],
          "format": "dc+sd-jwt",
          "id": "cred1",
          "meta": {
            "vct_values": [
              "AirlineLoyalty"
            ]
          }
        }
      ]
    },
    "nonce": "<redacted>",
    "purpose": "Verify loyalty tier for lounge access",
    "requested_claims": [
      "tier"
    ],
    "requested_vct": "AirlineLoyalty",
    "status": "pending",
    "transaction_id": "dd82f2c2-4c7b-477d-a1b6-4f0f95fd2af2",
    "uuid": "b713a8e2-9a10-4050-b800-6917b5ac50d7",
    "trust_policy": "tenant"
  }
]