Checks
Run a single check server-to-server, without a hosted session, and fetch its result.
Guide: direct checks.
Base URL https://api.okyc.stream/v1 · API version 2026-10-01 · authenticate with Authorization: Bearer sk_test_….
POST /v1/checks/{key}
Run a check without a hosted session.
Country key (in.pan.verify) or generic key with country (tax_id.verify + IN). ?async=true returns 202 and sends check.completed.
Parameters
| Name | In | Type | Required | Notes |
|---|---|---|---|---|
key | path | string | yes | e.g. in.pan.verify |
async | query | true | false | — |
Request body (DirectCheckInput, required)
| Field | Type | Required | Notes |
|---|---|---|---|
country | string | length 2 |
Responses
| Status | Description | Body |
|---|---|---|
200 | Completed | object (map) |
202 | Accepted | object (map) |
400 | Error | Error |
GET /v1/checks/{id}
Retrieve a check.
Parameters
| Name | In | Type | Required | Notes |
|---|---|---|---|---|
id | path | string | yes | e.g. ses_in_01j… |
Responses
| Status | Description | Body |
|---|---|---|
200 | OK | object (map) |
404 | Error | Error |
Sessions
Create, list, retrieve, decide and cancel verification sessions; evidence URLs and PII erasure.
Reference data
What each country supports, and the document types with their extractable fields.
© 2026 Aiistic Technologies Private Limited. OKYC is a product of Aiistic Technologies Private Limited. Privacy notice