curl -X GET \
"https://verilock.io/api/v1/sessions/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "X-API-Key: your_api_key_here" \
-H "Accept: application/json"
{
"id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"type": "kyc",
"status": "approved",
"reference_id": "usr_12345",
"steps": ["document", "selfie", "face_match", "liveness", "aml"],
"applicant": {
"first_name": "Jean",
"last_name": "Dupont",
"email": "jean.dupont@example.com",
"date_of_birth": "1990-05-15",
"nationality": "FR"
},
"results": {
"document": {
"status": "approved",
"type": "passport",
"details": {
"document_number": "12AB34567",
"issuing_country": "FR",
"expiry_date": "2030-08-21"
}
},
"selfie": {
"status": "approved"
},
"face_match": {
"status": "approved",
"score": 0.97,
"details": {
"similarity": "very_high"
}
},
"liveness": {
"status": "approved",
"score": 0.99,
"details": {
"is_live": true
}
},
"aml": {
"status": "approved",
"score": 0.02,
"details": {
"pep": false,
"sanctions": false,
"adverse_media": false
}
}
},
"hosted_url": "https://verilock.io/verify/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"created_at": "2026-03-15T10:30:00Z",
"completed_at": "2026-03-15T10:45:22Z"
}
Retrieve the full details of a verification session, including verification results.
curl -X GET \
"https://verilock.io/api/v1/sessions/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "X-API-Key: your_api_key_here" \
-H "Accept: application/json"
{
"id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"type": "kyc",
"status": "approved",
"reference_id": "usr_12345",
"steps": ["document", "selfie", "face_match", "liveness", "aml"],
"applicant": {
"first_name": "Jean",
"last_name": "Dupont",
"email": "jean.dupont@example.com",
"date_of_birth": "1990-05-15",
"nationality": "FR"
},
"results": {
"document": {
"status": "approved",
"type": "passport",
"details": {
"document_number": "12AB34567",
"issuing_country": "FR",
"expiry_date": "2030-08-21"
}
},
"selfie": {
"status": "approved"
},
"face_match": {
"status": "approved",
"score": 0.97,
"details": {
"similarity": "very_high"
}
},
"liveness": {
"status": "approved",
"score": 0.99,
"details": {
"is_live": true
}
},
"aml": {
"status": "approved",
"score": 0.02,
"details": {
"pep": false,
"sanctions": false,
"adverse_media": false
}
}
},
"hosted_url": "https://verilock.io/verify/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"created_at": "2026-03-15T10:30:00Z",
"completed_at": "2026-03-15T10:45:22Z"
}
ses_a1b2c3d4-...)| Status | Description |
|---|---|
approved | The verification step passed successfully |
declined | The verification step failed |
pending | The step is still being processed |
not_started | The step has not been initiated yet |
curl -X GET \
"https://verilock.io/api/v1/sessions/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-H "X-API-Key: your_api_key_here" \
-H "Accept: application/json"
{
"id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"type": "kyc",
"status": "approved",
"reference_id": "usr_12345",
"steps": ["document", "selfie", "face_match", "liveness", "aml"],
"applicant": {
"first_name": "Jean",
"last_name": "Dupont",
"email": "jean.dupont@example.com",
"date_of_birth": "1990-05-15",
"nationality": "FR"
},
"results": {
"document": {
"status": "approved",
"type": "passport",
"details": {
"document_number": "12AB34567",
"issuing_country": "FR",
"expiry_date": "2030-08-21"
}
},
"selfie": {
"status": "approved"
},
"face_match": {
"status": "approved",
"score": 0.97,
"details": {
"similarity": "very_high"
}
},
"liveness": {
"status": "approved",
"score": 0.99,
"details": {
"is_live": true
}
},
"aml": {
"status": "approved",
"score": 0.02,
"details": {
"pep": false,
"sanctions": false,
"adverse_media": false
}
}
},
"hosted_url": "https://verilock.io/verify/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"created_at": "2026-03-15T10:30:00Z",
"completed_at": "2026-03-15T10:45:22Z"
}