Create verification
curl --request POST \
--url https://api.txcloud.io/v1/identity/verify \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document_front": "aSDinaTvuI8gbWludGxpZnk=",
"country": "MA",
"document_back": "aSDinaTvuI8gbWludGxpZnk=",
"selfie": "aSDinaTvuI8gbWludGxpZnk=",
"checks": [
"ocr",
"face_match",
"liveness",
"fraud"
],
"mode": "sync",
"webhook_url": "<string>",
"metadata": {}
}
'{
"id": "ver_a1b2c3d4e5f6",
"object": "identity.verification",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"document_type": "<string>",
"country": "<string>",
"extracted_data": {
"document_number": "AE123456",
"first_name": "Mohammed",
"last_name": "El Amrani",
"first_name_arabic": "<string>",
"last_name_arabic": "<string>",
"date_of_birth": "2023-12-25",
"nationality": "<string>",
"issue_date": "2023-12-25",
"expiry_date": "2023-12-25",
"address": "<string>",
"place_of_birth": "<string>",
"mrz": "<string>",
"field_confidences": {}
},
"checks": {
"ocr": {
"confidence": 0.5
},
"face_match": {
"confidence": 0.5,
"similarity_score": 123,
"threshold": 123
},
"liveness": {
"confidence": 0.5,
"is_live": true,
"spoof_probability": 123
},
"fraud": {
"confidence": 0.5,
"tampering_detected": true,
"signals": [
"<string>"
]
},
"duplicate": {
"confidence": 0.5
}
},
"risk_score": 500,
"fraud_signals": [
{
"code": "<string>",
"message": "<string>"
}
],
"metadata": {}
}Verification
Create verification
Performs a full identity verification including document OCR, face matching, liveness detection, and fraud checks.
Checks Available:
ocr- Extract data from documentface_match- Compare selfie to document photoliveness- Detect if selfie is a live personfraud- Check for document tamperingduplicate- Check for duplicate submissions
Processing Modes:
sync- Wait for results (default, up to 30s)async- Return immediately, results via webhook
POST
/
identity
/
verify
Create verification
curl --request POST \
--url https://api.txcloud.io/v1/identity/verify \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document_front": "aSDinaTvuI8gbWludGxpZnk=",
"country": "MA",
"document_back": "aSDinaTvuI8gbWludGxpZnk=",
"selfie": "aSDinaTvuI8gbWludGxpZnk=",
"checks": [
"ocr",
"face_match",
"liveness",
"fraud"
],
"mode": "sync",
"webhook_url": "<string>",
"metadata": {}
}
'{
"id": "ver_a1b2c3d4e5f6",
"object": "identity.verification",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"document_type": "<string>",
"country": "<string>",
"extracted_data": {
"document_number": "AE123456",
"first_name": "Mohammed",
"last_name": "El Amrani",
"first_name_arabic": "<string>",
"last_name_arabic": "<string>",
"date_of_birth": "2023-12-25",
"nationality": "<string>",
"issue_date": "2023-12-25",
"expiry_date": "2023-12-25",
"address": "<string>",
"place_of_birth": "<string>",
"mrz": "<string>",
"field_confidences": {}
},
"checks": {
"ocr": {
"confidence": 0.5
},
"face_match": {
"confidence": 0.5,
"similarity_score": 123,
"threshold": 123
},
"liveness": {
"confidence": 0.5,
"is_live": true,
"spoof_probability": 123
},
"fraud": {
"confidence": 0.5,
"tampering_detected": true,
"signals": [
"<string>"
]
},
"duplicate": {
"confidence": 0.5
}
},
"risk_score": 500,
"fraud_signals": [
{
"code": "<string>",
"message": "<string>"
}
],
"metadata": {}
}Authorizations
API key as Bearer token
Body
application/jsonmultipart/form-data
Base64 encoded front of document
Available options:
cin, cni, passport, permit, residence_card Pattern:
^[A-Z]{2}$Example:
"MA"
Base64 encoded back of document
Base64 encoded selfie image
Available options:
ocr, face_match, liveness, fraud, duplicate Available options:
sync, async Webhook URL for async results
Custom metadata
Response
Verification completed (sync mode)
Example:
"ver_a1b2c3d4e5f6"
Available options:
identity.verification Available options:
pending, verified, rejected, review, expired, error Show child attributes
Show child attributes
Show child attributes
Show child attributes
Required range:
0 <= x <= 1000Available options:
low, medium, high, critical Show child attributes
Show child attributes
⌘I