Skip to content

RandaVerify API

Identity verification powered by Nigeria's NIMC, delivered as a JSON API.

The RandaVerify API powers identity verification for Self-Hosted tenants — organisations that operate their own systems and call our API for verification rather than logging in to the RandaVerify portal.

If you are a Hosted Affiliate tenant (you log in at app.randaverify.com) you do not need to read these docs. Everything described here is wired into the portal for you.

Free slip prints

Every successful verification entitles you to unlimited PDF slip generation at ₦0 per print — unlike most providers, RandaVerify charges only for the verification itself.

Multiple verification modes

Verify by NIN, phone number, share code, in-person selfie match, or demographic data (first name + last name + DOB + gender).

Predictable pricing

Pay per unit on a wallet model. Loyalty badges (Silver / Gold / Diamond) recognise lifetime purchase volume.

Auditable

Every request creates a transaction row tied to the calling user, with a reference ID you can replay via the re-query endpoint.

  1. Getting started — base URLs, account setup, your first verification.
  2. Authentication — how to obtain and use the bearer token.
  3. Verification endpoints — the five verification modes plus re-query.
  4. Error reference — every status code you might receive and what to do about it.