Create Verification Session

POST 
/api/v1/verifier/sessions

Creates a new OpenID4VP verification session. Returns an authorizationUrl to display to the holder (typically as a QR code) to initiate credential presentation.

All request body fields are optional — an empty body {} creates a session with your configuration's defaults.

After creating the session, display the qrCodeDataUrl and poll GET /api/v1/verifier/sessions/{sessionId} every 3–5 seconds until the session reaches a terminal state (completed or failed).

Request

Responses

201

Verification session created.

400

Invalid request — a field exceeds its max length or presentationDefinitionId is invalid.

401

Authentication required — missing, invalid, or expired access token.

403

Verifier not authorized — your token lacks the required scope, or your configuration is not permitted to request this credential type.

500

Internal server error — platform error.

503

Backend unavailable — retry with exponential backoff.