OpenID4VP Verification

Get a verification result

Fetch a single verification result by id for the authenticated tenant. Returns the verification payload — verdict, requested and disclosed claims, the per-check booleans, and the verifier audience. Scoped to the tenant via the API key; a verification belonging to another tenant (or an unknown/soft-deleted id) returns 404. Authenticated with the tenant API key.

get/v1/verifications/{uuid}

Path parameters

uuidstring uuid required

UUID of the verification result record to fetch. Scoped to the authenticated tenant; a sibling-tenant, unknown, or soft-deleted id returns 404.

Response

The verification payload for the requested result.

idstring uuid

Unique identifier of the verification result record.

request_idstring uuid

UUID of the presentation request this verification answers.

verdict'verified' | 'failed'

Outcome of verification.

vctstring

The Verifiable Credential Type that was requested and presented.

verifierstring

The verifier audience (the request's aud — client_id / origin).

requested_claimsstring[]

The claim names the request asked to be disclosed.

disclosed_claimsobject

Map of claim name to value for the claims disclosed. Empty when the verdict is failed.

errorstring

Failure reason (ExceptionType: message) when the verdict is failed; empty string on success.

created_atstring date-time

ISO 8601 timestamp when the verification result was recorded.

Example response

{
  "id": "b2c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
  "request_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "verdict": "verified",
  "vct": "https://credentials.didit.me/vct/identity-card",
  "verifier": "https://checkin.acme-air.com",
  "requested_claims": [
    "given_name",
    "family_name",
    "birth_date"
  ],
  "disclosed_claims": {
    "given_name": "Ada",
    "family_name": "Lovelace",
    "birth_date": "1815-12-10"
  },
  "checks": {
    "signature": true,
    "key_binding": true,
    "aud": true,
    "nonce": true,
    "alg_allowlist": true,
    "not_expired": true,
    "not_revoked": true
  },
  "created_at": "2026-06-30T12:00:00+00:00"
}

Changes