Changelog

All notable changes to the public API surface and the integrator experience are recorded here. The format roughly follows Keep a Changelog.

v1.0.0 — “Rabbit” (2026-05)

Inaugural public release. Marks the start of the v1 compatibility contract — see Versioning.

All public endpoints are now served from https://api.randaverify.com/v1/. The unversioned form is still accepted for backward compatibility but new integrators should use /v1/ exclusively.
Test mode via fixture NINs — production is the single base URL; integration testing is done by sending fixture NIN values (12345678901 happy, 12345678902 sparse, 99999999999 not-found) that bypass NIMC and consume zero units. See Testing.
Phone verification endpoint — POST /v1/verify-nin/phone.
Demography verification endpoint — POST /v1/verify-nin/demography (reason pinned to nyscCheck).
Loyalty badges for Self-Hosted tenants — Silver (20k), Gold (30k), Diamond (50k lifetime units). Shown on the platform admin org page and in the customer’s payment-receipt email.
Early-bird bonus — free bonus units on Hosted Affiliate top-ups through 15 June 2026 (Self-Hosted does not qualify).
Free slip prints — there is no per-print charge on the platform.
KYB onboarding now requires CAC + NDPR documentation upfront — see Getting started → Prerequisites.
Backend normalisation: every verification response now carries the same field schema regardless of which mode produced it.

The verification response is wrapped in a data envelope ({ "data": { … } }) on every mode for consistency.
The org-delete admin flow now requires the wallet to be empty (zero stranded units).

normalize_nin_record now includes residenceLga in the response.
NIN field correctly populates on phone responses for records where NIMC returns it.