Zentaras API
v1.4.2 · REST · JSON · TLS 1.3
Zentaras AI API
The Zentaras API is organized around REST. Predictable resource-oriented URLs, JSON-encoded responses, conventional HTTP response codes, and standard authentication. Verify identities in 195+ countries with a single, unified interface.
Base URL
https://api.zentaras.online/v1Quickstart
Create your first verification in under 60 seconds. Generate an API key from the dashboard, then issue your first request.
curl -X POST https://api.zentaras.online/v1/verifications \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"type": "kyc",
"applicant": {
"first_name": "Aarav",
"last_name": "Sharma",
"dob": "1995-04-12",
"country": "IN"
},
"checks": ["document", "face_match", "liveness", "aml"]
}'Response
A successful request returns a verification object with check results and a risk score (0–100, lower is safer).
{
"id": "ver_8f3a1c9b2e7d4f6a",
"object": "verification",
"type": "kyc",
"status": "approved",
"created_at": "2025-04-17T09:42:11Z",
"completed_at": "2025-04-17T09:42:19Z",
"duration_ms": 8104,
"applicant": {
"first_name": "Aarav",
"last_name": "Sharma",
"dob": "1995-04-12",
"country": "IN"
},
"checks": {
"document": {
"status": "passed",
"document_type": "aadhaar",
"extracted": { "name": "Aarav Sharma", "id_number": "XXXX-XXXX-1234" }
},
"face_match": { "status": "passed", "score": 0.987 },
"liveness": { "status": "passed", "score": 0.992 },
"aml": { "status": "clear", "matches": 0 }
},
"risk_score": 4
}Authentication
Authenticate using your secret API key in the Authorization header. Keep keys secret — never expose them in client-side code or public repositories.
Real verifications, billed usage.
Free, mock data, no billing.
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxEnvironments
| Environment | Base URL | Region |
|---|---|---|
| Production (Global) | api.zentaras.online/v1 | Anycast |
| Production (India) | in.api.zentaras.online/v1 | ap-south-1 |
| Sandbox | sandbox.zentaras.online/v1 | Global |
Endpoints
All resources you can interact with through the REST API.
/v1/verificationsCreate a new verification session/v1/verifications/:idRetrieve a verification/v1/verificationsList verifications/v1/documents/ocrExtract data from a document/v1/biometrics/face-matchCompare two faces/v1/biometrics/livenessRun a liveness check/v1/aml/screenScreen against sanctions & PEP lists/v1/kyb/companiesVerify a business entity/v1/webhooksRegister a webhook endpointDocument OCR
Extract structured data from 11,000+ document types — passports, national IDs, driver licenses, Aadhaar, PAN, utility bills.
curl -X POST https://api.zentaras.online/v1/documents/ocr \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxx" \
-F "front=@passport_front.jpg" \
-F "back=@passport_back.jpg" \
-F "document_type=passport"Biometrics & Liveness
ISO 30107-3 PAD Level 2 certified passive liveness with 99.7% accuracy. No user prompts required.
Face match score
Cosine similarity in [0, 1]. Recommend ≥ 0.85 for retail, ≥ 0.92 for banking.
Liveness signal
Detects deepfakes, masks, screens, printed photos. Single selfie, no head turns.
AML Screening
Screen against 1,400+ global watchlists — OFAC, UN, EU, HMT, RBI, MHA — plus PEP and adverse media. Updated every 15 minutes.
{
"id": "aml_5c7d9e1a3b4f",
"status": "clear",
"matches": 0,
"lists_checked": 1432,
"fuzzy_score_threshold": 0.85,
"checked_at": "2025-04-17T09:42:14Z"
}KYB / Business Verification
Verify companies and beneficial owners across 240M+ registries worldwide. UBO graph traversal up to 5 levels deep.
Webhooks
We POST events to your endpoint as they happen. Signed with HMAC-SHA256 in the Zentaras-Signature header.
Errors & Rate Limits
Conventional HTTP codes. 2xx success, 4xx client errors, 5xx server errors. Rate limit: 100 req/s per key, burstable to 500.
| Code | Type | Description |
|---|---|---|
| 400 | bad_request | Malformed request or invalid parameters |
| 401 | unauthorized | Missing or invalid API key |
| 403 | forbidden | API key lacks permission for this resource |
| 404 | not_found | Resource does not exist |
| 409 | conflict | Duplicate verification for this applicant |
| 422 | validation_error | Document unreadable or face not detected |
| 429 | rate_limited | Too many requests — back off and retry |
| 500 | server_error | Something went wrong on our side |
Official SDKs
Node.js
npm i @zentaras/nodePython
pip install zentarasGo
go get github.com/zentaras/zentaras-goJava
implementation 'ai.zentaras:sdk:1.4.2'Compliance & Security
SOC 2 Type II, ISO 27001, ISO 27701, PCI DSS, GDPR, DPDP Act 2023, RBI Master Direction on KYC. All data encrypted at rest (AES-256) and in transit (TLS 1.3).
Ready to integrate?
Get your sandbox API key and ship your first verification in under an hour.