Documentation
Contact

Verification States KYC

Five Main States

StateIconDescription
Adopted✅User completed and passed all validations
Rejected❌User did not meet safety criteria or exceeded permitted attempts
Under review⚠️Requires manual validation by an agent
Assigned⌛️User did not complete flow within time limit
Stretch / Uninitiated📋Session created but user haven't started

Identification Methodology

Based on an attempt to balance security with user experience.

Document Verification Meters

AttemptsState
1-3Adopted
4-5Under review
+5Rejected

Liveness threshold

AttemptsState
1-2Adopted
3Under review
+3Rejected

OTO Biometric Comparison Meters

AttemptsState
1Approved or Rejected (determined immediately)
+1Automatic rejection

States in response API

Stretch / Uninitiated

{
  "state": "",
  "statusDetail": { "state": "", "stage": "" }
}

Assigned

{
  "state": "",
  "statusDetail": { "state": "finished", "stage": "lapsed_motor" }
}

Under review

{
  "status": "NEED_REVIEW",
  "statusDetail": { "state": "finished", "stage": "in_review" }
}

Adopted

{
  "status": "PASS",
  "statusDetail": { "state": "finished", "stage": "approved" }
}

Rejected

{
  "status": "FAIL",
  "statusDetail": { "state": "finished", "stage": "rejected" }
}

Consultation Endpoint

GET /v1/kyc/session/{{sessionID}}