Government ID Verification

Verify national ID and related government checks. On production (https://api.peleza.com), Kenya National ID uses a single route with a required scope.

Overview

Start with OAuth client credentials, then call the KYC endpoints under API Integration. Production: https://api.peleza.com. Sandbox: https://sandbox.peleza.com.

Kenya National ID — POST /api/v1/id/ke

Preferred endpoint for Kenyan national ID. Send id_number, consent: true, and scope:

scope: "basic" — demographics (billed as national-id)
scope: "full" — full record + media URLs when available (billed as national-id-image)

HTTP 200 and 404 are billable. Validation errors (400) are not. Legacy paths /api/v1/national-id and /api/v1/national-id-image are not available on the Go API — use /api/v1/id/ke only.

Full reference: National ID.

Other Kenya KYC endpoints

Additional identity APIs:

Maisha Number — POST /api/v1/maisha-number (new-generation ID; billed as maisha-number; response uses serial_no; sandbox test ID 1028845319)
POST /api/v1/alien-id — alien / immigration cards
POST /api/v1/passport/ke — passport_number and/or id_number (live on Go API; billed as passport)
POST /api/v1/phone-id/ke — phone + ID verification
POST /api/v1/bank-account/ke — account name verification (use GET /api/v1/banks/ke for bank_id)

Loading sandbox test IDs…

Next steps

Open API Integration → Kenya for full request/response references. For wallet and VAT behaviour on billable calls, see Wallet Balance and API Keys.