Skip to main content

​
Run KYC

POST /api/v1/kyc

{
  "participant_id": "uuid",
  "type": "individual",
  "scenario": "identity",
  "payload": {
    "identifier_type": "national_id",
    "identifier_number": "12345678",
    "country": "KE"
  }
}

​
Check status

GET /api/v1/kyc/{id}
StatusMeaning
pendingQueued
processingIn progress
verifiedIdentity confirmed
failedCould not verify
manual_reviewNeeds human review

​
Sync result to participant

POST /api/v1/kyc/{id}/sync
Updates the participant with verified name, date of birth, address, and extracted face photo.

​
Organization KYC

POST /api/v1/organizations/{id}/run-kyc

{"autoSync": true}
Creates participant records for all identified directors automatically.