v8

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

OpenID4VP Verification

List the tenant's presentation requests (alias of /presentations/requests).

List your tenant's OpenID4VP (OpenID for Verifiable Presentations) presentation requests. This alias returns the same bare JSON array as GET /v1/presentations/requests.

get/v1/presentations/request

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.366681Z",
    "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": "287d95fb-798b-47ee-9762-ccafca4aa3b0",
    "uuid": "1a2a5c82-3779-424b-a900-2062fdfaf5d2",
    "trust_policy": "tenant"
  }
]