Developer Documentation

Idensys API Documentation

Simple integration guides for Kenyan identity verification workflows.

OTP Verification

Send a one-time password to a Kenyan phone number and verify the submitted code.

POST /otp/send
{
  "phone_number": "+254712345678"
}

POST /otp/verify
{
  "phone_number": "+254712345678",
  "otp": "482910"
}

ID Details Verification

Validate a customer's ID details by checking ID number, first name, and date of birth consistency.

POST /verify/id-details
{
  "id_number": "12345678",
  "first_name": "Amina",
  "date_of_birth": "1994-08-10"
}

{
  "status": "verified",
  "match_score": 0.97
}

ID Scanning

Upload a national ID, passport, or military ID image to extract key fields automatically.

POST /scan/document
{
  "document_type": "national_id",
  "front_image": "base64...",
  "back_image": "base64..."
}

{
  "full_name": "Amina Wanjiku",
  "document_number": "12345678",
  "date_of_birth": "1994-08-10"
}

Liveness Scanning

Run an interactive selfie flow with gesture checks to confirm a real person is present.

POST /verify/liveness
{
  "session_id": "live_abc123",
  "selfie_image": "base64...",
  "gesture": "turn_head_left"
}

{
  "status": "passed",
  "liveness_score": 0.99
}

Face Match

Compare face from ID document with selfie captured during liveness check.

POST /verify/face-match
{
  "document_face": "base64...",
  "selfie_face": "base64..."
}

{
  "status": "matched",
  "confidence": 0.98
}

Quick Integration Steps

  1. Create your account and generate API keys.
  2. Call document scan and liveness endpoints from your onboarding flow.
  3. Use verification decision response to auto-approve or escalate review.
  4. Optionally add OTP verification for high-risk actions.