Government ID Verification

Verify national IDs with POST /api/v1/id/{country} on production (https://api.peleza.com) and sandbox (https://sandbox.peleza.com). Every request requires consent: true.

Overview

Start with OAuth client credentials, then call the country ID endpoints under API Integration. Supported country codes: ke, ao, ug, za, zm, zw, gh, ng. Unsupported codes return 404.

Combined reference: Country IDs overview.

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

Verify a Kenyan national ID. Send id_number, consent: true, and scope:

• scope: "basic" — demographics
• scope: "full" — full record, including media URLs when available

Legacy paths /api/v1/national-id and /api/v1/national-id-image are not available — use /api/v1/id/ke only.

Full reference: National ID.

Other countries — POST /api/v1/id/{country}

Each country returns its own field set. Ghana Card must be a Personal ID GHA-#########-# — document numbers are rejected.

• Angola — /id/ao
• Uganda — /id/ug; id_type=nin (default) or voter (requires first_name and last_name)
• South Africa — /id/za
• Zambia NRC — /id/zm; format ######/##/#
• Zimbabwe — /id/zw
• Ghana Card / Voter — /id/gh; Ghana Card by default, or id_type=voter
• Nigeria NIN — /id/ng; 11 digits; optional id_type=nin_advance

Other Kenya KYC endpoints

Additional identity APIs:

• Maisha Number — POST /api/v1/maisha-number (new-generation ID; 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
• 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)

Next steps

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