v8

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

OpenID4VP Verification

Create a presentation request (alias of POST /v1/presentations/request)

Create a presentation request (alias of POST /v1/presentations/request).

post/v1/presentations/requests

Request body

audstring

purposestring

requested_claimsstring[]

requested_vctstring

relying_party_idstring uuid

You optionally scope this request to a registered relying party by UUID. When set, the relying party's per-RP trust rules apply on top of the tenant registry.

Example request

{
  "aud": "checkin-rp",
  "purpose": "Verify loyalty tier for lounge access",
  "requested_claims": [
    "tier"
  ],
  "requested_vct": "AirlineLoyalty",
  "relying_party_id": "44b2d61a-1634-486b-a35a-df26eb653a1a"
}

Response

Successful response.

audstring

created_atstring

noncestring

purposestring

requested_claimsstring[]

requested_vctstring

statusstring

transaction_idstring

trusted_issstring

uuidstring

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"
}