v8

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

OpenID4VP Verification

Submit a vp_token for verification

Submit a wallet response for an OpenID4VP (OpenID for Verifiable Presentations) presentation request. You post the vp_token, and the API verifies the SD-JWT VC (Selective-Disclosure JWT Verifiable Credential), KB-JWT (Key-Binding JWT), nonce, audience, revocation status, and signature.

post/v1/presentations/{uuid}/response

Path parameters

uuidstring uuid required

Identifies the presentation request being answered.

Request body

vp_tokenstring required

Contains the OpenID4VP (OpenID for Verifiable Presentations) presentation token from the wallet.

Example request

{
  "vp_token": "<redacted>"
}

Response

Returns a verified presentation response.

uuidstring uuid

Identifies the verification result.

verdict'verified'

Shows whether the presentation verified successfully.

errorstring

Returns an empty string on success or a failure reason when verification fails.

created_atstring date-time

Records when the verification result was created.

Example response

{
  "uuid": "7b2322e2-4cdf-4167-b718-ee29183b1bf2",
  "verdict": "verified",
  "disclosed_claims": {
    "tier": "gold"
  },
  "checks": {
    "alg_allowlist": true,
    "aud": true,
    "key_binding": true,
    "nonce": true,
    "not_expired": true,
    "not_revoked": true,
    "signature": true
  },
  "created_at": "2026-07-02T23:33:33.575716Z"
}