Read the applicant data that a verification session captured: the name, the date of birth, the country, the nationality, the address, and the identity document. data is null when the session captured no applicant data. Webhooks never carry this data. The session must be APPROVED or REJECTED: any other status answers 409. The response carries Cache-Control: no-store. Signa must be enabled for your business. Required scope: compliance-kyc:pii:read. No scope bundle contains this scope, full-access included, so select it by name when you create or rotate your credentials.
Authorization
oauth2ClientCredentials compliance-kyc:pii:readUse your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.
In: header
Scope: compliance-kyc:pii:read
Path Parameters
The verification session id returned by the create endpoint.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl --request GET \ --url 'https://example.com/api/external/compliance/kyc/sessions/9f2c7b41-6d3e-4c8a-9a20-1e6f0b5d7c33/applicant-data'{ "message": "Session applicant data retrieved successfully.", "data": { "session_id": "9f2c7b41-6d3e-4c8a-9a20-1e6f0b5d7c33", "first_name": "Amara", "middle_name": null, "last_name": "Okafor", "date_of_birth": "1993-04-17", "country": "NGA", "nationality": "NGA", "address": { "line": "14 Admiralty Way", "city": "Lagos", "state": "Lagos", "postal_code": "106104" }, "document": { "type": "PASSPORT", "number": "A05729314", "issuing_country": "NGA", "issue_date": "2021-06-02", "expiry_date": "2031-06-01" }, "extracted_at": "2026-08-29T09:31:07.000Z" }}POSTCancel a verification session
Cancel a session that you no longer need. CANCELLED is terminal: Blaaiz sends no webhook for the session after a cancel, and the verification link stops working. A cancel frees a slot under your open session cap. A cancel on a session that is already terminal is refused with `422`: `This session has already been cancelled.` for a cancelled session, and `This session has already reached a final state and cannot be cancelled.` for an approved, rejected or expired one. A cancel also closes the person's verification page. The request takes no body. This endpoint stays available even when Signa is disabled for your business. Required scope: `compliance-kyc:cancel`.
GETList session documents
List the images that a verification session captured: the identity document, the selfie, the proof of address, and the face image from the liveness check. The list holds descriptions only. To download an image, call the document URL endpoint with its `id`. Blaaiz keeps the face image from the liveness check for 30 days. After that, the list shows it with `available: false` and `unavailable_reason: NOT_RETAINED`. The session must be APPROVED or REJECTED: any other status answers 409. The response carries `Cache-Control: no-store`. Signa must be enabled for your business. Required scope: `compliance-kyc:pii:read`. No scope bundle contains this scope, `full-access` included, so select it by name when you create or rotate your credentials.