v8

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

OpenID4VP Verification

Poll a presentation request (holder + status)

Fetch the holder-facing view of one OpenID4VP (OpenID for Verifiable Presentations) presentation request. You can use it to render the requester, purpose, requested claims, and current request status.

get/v1/presentations/{uuid}

Path parameters

uuidstring uuid required

Identifies the presentation request to fetch.

Response

Returns the public presentation request view for the holder.

uuidstring uuid

Identifies the presentation request.

transaction_idstring uuid

Binds the presentation request to the later verification result.

requested_vctstring

Names the requested VCT (Verifiable Credential Type).

requested_claimsstring[]

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

audstring

Identifies the verifier audience for the presentation.

noncestring

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

purposestring

Explains why the verifier requests the presentation.

trusted_issstring

Returns the trusted issuer value configured for the request.

status'pending'

Shows the current state of this presentation request.

created_atstring date-time

Records when the presentation request was created.

Example response

{
  "uuid": "71889d7a-67c1-4ce9-bb73-5e99cd4c0265",
  "transaction_id": "1aa51264-f2d2-4a97-86b8-940a9c0e1188",
  "dcql": {
    "credentials": [
      {
        "claims": [
          {
            "path": [
              "<redacted>"
            ]
          }
        ],
        "format": "<redacted>",
        "id": "<redacted>",
        "meta": {
          "vct_values": [
            "<redacted>"
          ]
        }
      }
    ]
  },
  "requested_vct": "AirlineLoyalty",
  "requested_claims": [
    "tier"
  ],
  "aud": "checkin-rp",
  "nonce": "<redacted>",
  "purpose": "Verify loyalty tier for lounge access",
  "status": "pending",
  "created_at": "2026-07-02T23:33:33.500617Z",
  "requester": {
    "did": "did:web:docs-capture-6clew6.didit.test",
    "id": "relying-party",
    "name": "checkin-rp",
    "purpose": "Verify loyalty tier for lounge access"
  },
  "claims": [
    {
      "label": "Tier",
      "name": "tier",
      "requested": true,
      "selective_disclosure": true
    }
  ]
}