---
title: "Create Verification"
method: POST
path: "/v1/verifications"
tags: ["Verifications"]
---

# Create Verification

`POST /v1/verifications`

Initiates a new identity verification session with the specified eID provider.

## Request body

- CreateVerificationRequest
  - `providerId` string, required — The identifier for the desired eID provider.
  - `redirectUri` string, uri — URL to redirect to after a redirect-based verification.
  - `webhookUrl` string, uri — URL to receive asynchronous status updates.
  - `userData` object — User information required by certain eID providers.

## Response `201`

Verification session created successfully.

- CreateVerificationResponse
  - `verificationId` string
  - `status` 'initiated' | 'pending'
  - `providerId` string
  - `flowType` 'qr' | 'redirect' | 'push'
  - `flowDetails` object
    - `qrData` string — Base64 data for QR code generation.
    - `authorizationUrl` string, uri — URL for browser redirection.
  - `expiresAt` string, date-time
  - `createdAt` string, date-time

## Other responses

- `400` — Bad Request - Invalid parameters or eID not enabled.
- `401` — Unauthorized - Invalid client credentials.

---

[API](https://skmtc.net/hopae/apis/hconnect-api.md) · [All operations](https://skmtc.net/hopae/apis/hconnect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hopae/hconnect-api/revisions/ed6e97ac6f2f/schema)