SupportDashboard
HomeGet StartedPaymentsCryptoComplianceChangelog

List verification sessions

List the verification sessions of your business. The listing is always scoped to the business behind your access token. This endpoint stays available even when Signa is disabled for your business. Required scope: compliance-kyc:read.

GETapi-prod.blaaiz.com/api/external/compliance/kyc/sessions

Authorization

oauth2ClientCredentials compliance-kyc:read
AuthorizationBearer <token>

Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.

In: header

Scope: compliance-kyc:read

Query Parameters

limit?integer

How many sessions to return. The default is 20 and the maximum is 100.

Range1 <= value <= 100
Default20
offset?integer

How many sessions to skip. The default is 0.

Range0 <= value
Default0

Response Body

application/json

application/json

application/json

application/json

List verification sessions
curl --request GET \  --url 'https://example.com/api/external/compliance/kyc/sessions'
{  "message": "Verification sessions retrieved successfully.",  "data": {    "sessions": [      {        "id": "9f2c7b41-6d3e-4c8a-9a20-1e6f0b5d7c33",        "business_id": "9d4c4ec5-572d-49de-a362-f01ed09f2b1b",        "customer_reference": "user_10482",        "requirements": [          "DOCUMENTS",          "SELFIE",          "FACE_MATCH"        ],        "fulfilment_mode": "HOSTED",        "status": "AWAITING_INPUT",        "steps": {          "documents": "PENDING",          "selfie": "PENDING",          "proof_of_address": null        },        "rejection": null,        "expires_at": "2026-08-30T09:14:22.000Z",        "completed_at": null,        "created_at": "2026-08-29T09:14:22.000Z"      },      {        "id": "9f2c7b41-6d3e-4c8a-9a20-1e6f0b5d7c33",        "business_id": "9d4c4ec5-572d-49de-a362-f01ed09f2b1b",        "customer_reference": "user_10482",        "requirements": [          "DOCUMENTS"        ],        "fulfilment_mode": "HEADLESS",        "status": "AWAITING_INPUT",        "steps": {          "documents": "SUBMITTED",          "selfie": null,          "proof_of_address": null        },        "rejection": null,        "expires_at": "2026-08-30T09:14:22.000Z",        "completed_at": null,        "created_at": "2026-08-29T09:14:22.000Z"      }    ]  }}

POSTCreate a verification session

Create a verification session for one person. The response normally returns status AWAITING_INPUT. A status of CREATED means the setup did not finish; repeat the call with the same idempotency_key. A repeat with the same idempotency_key returns the stored session. A repeat with the same key but a different customer_reference or a different requirement set returns 422. Signa must be enabled for your business. Required scope: `compliance-kyc:create`.

GETGet a verification session

Get the current state of one verification session. Use it to poll a session, and to recover a result after a webhook delivery fails. A session that belongs to another business answers exactly like a session that does not exist. This endpoint stays available even when Signa is disabled for your business. Required scope: `compliance-kyc:read`.