Verification ChecksIdentity

ID verification with image

Verify a Kenyan ID with image-backed IPRS details.

Send IDENTITY_WITH_IMAGE in checksRequested to run this check.

Verifies identity details and includes image-backed evidence. Upload the front of the identity document before creating the report.

The request

POST /api/v1/reports
{
  "subject": {
    "fullName": "Jane Doe",
    "idNumber": "36901234",
    "email": "jane@example.com",
    "phone": "+254712345678",
    "country": "KE",
    "subjectType": "INDIVIDUAL"
  },
  "checksRequested": [
    "IDENTITY_WITH_IMAGE"
  ],
  "attachments": [
    {
      "checkType": "IDENTITY_WITH_IMAGE",
      "documentId": "7f000001-a1b0-1000-81a1-b00000000091"
    }
  ],
  "purpose": "Customer onboarding",
  "consent": {
    "mode": "VERIFISHA_HOSTED"
  }
}

The acknowledgement

Creation is asynchronous. The report comes back as a draft; the check runs after.

201 Created
{
  "reports": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "status": "DRAFT",
      "paymentState": {
        "status": "NOT_REQUIRED",
        "amount": {
          "amount": 0.1,
          "currency": "KES"
        }
      },
      "consentState": {
        "status": "NOT_REQUIRED"
      }
    }
  ],
  "count": 1
}

The result

When the check finishes, this arrives at your webhook. COMPLETED means it ran — read riskLevel and flags to decide what it found.

On this page