Peleza — Trust built on data
Dashboard
Updates
On this page

Changelog

Latest releases, improvements, and breaking changes for the Peleza API.

August 2026 — Go API on api.peleza.com

  • Kenya National ID consolidated to POST /api/v1/id/ke with required consent and scope (basic | full).
  • Other-country IDs on the Go API and sandbox: POST /api/v1/id/{ao,ug,za,zm,zw,gh,ng} with required consent: true. Ghana Card requires Personal ID GHA-#########-# (document numbers rejected). Billing: id-ao, id-ug, id-za, id-zm, zimbabwe-national-id, ghana-card / ghana-voter, id-ng / nigeria-nin-advance.
  • Legacy Go routes /api/v1/national-id and /api/v1/national-id-image removed — migrate to /id/ke.
  • Basic responses include serial_number; scope / status are not returned in data.
  • One api_request_logs row per client call with request and response details for support and audit.
  • Wallet debit transactions use uppercase references (e.g. APIK7M2Q9X4P1).
  • KES wallets with tenant VAT enabled debit subtotal + VAT; non-KES currencies skip VAT.
  • Added docs for GET /api/v1/oauth/validate and GET /api/v1/wallet/balance. Validate returns valid and expires_at only (no credential identifiers).
  • Kenya Passport on the Go API: POST /api/v1/passport/ke (billed as passport).
  • Maisha Number on the Go API: POST /api/v1/maisha-number (billed as maisha-number). Requires consent: true. Success payload includes serial_no when available. Also live on sandbox with test ID 1028845319.
  • Phone + ID on the Go API: POST /api/v1/phone-id/ke (combined phone and national ID verification; billed as phone-id).
  • Driving License on the Go API: POST /api/v1/dl/ke (billed as driving-license).
  • Motor Vehicle Records on the Go API: POST /api/v1/mvr/ke (billed as vehicle-plate). NTSA via Malipo is primary; CreditInfo is fallback only when Malipo never submitted. Success payload now includes year_of_manufacture, owner_type, flagged, inspection, and charges. HTTP 200 and 404 are billed; 503 is not.
  • KRA on the Go API: POST /api/v1/kra-pin-by-id, /kra-pin-by-pin.
  • Business / KYB on the Go API: POST /api/v1/business/ke with search_type pvt | bn | llp | bo (billed as company / business / limitted / business-ownership). Requires consent: true.

Breaking changes

Clients calling the Go API must use National ID with scope and consent. Do not call removed legacy national-id paths on the Go host.