Registry Sandbox is a local test system for NIN (National Identification Number) and BVN (Bank Verification Number) enrollment and lookup flows. It exists so you can develop and test against something that behaves like a national identity registry, without touching real government or banking data.
Every record in this system is fabricated. Names, addresses, and phone numbers come from curated reference lists, not real people. NIN and BVN numbers are randomly generated 11-digit strings, checked for uniqueness against the local database only — they carry no meaning outside this sandbox.

​
What it does

  • Stores synthetic identity records in a local SQLite database
  • Lets you enroll new test people through a web UI, issuing a NIN, a BVN, or both
  • Lets you look up a full record by NIN or by BVN
  • Ships with a seed script that generates a batch of test people in one command
  • Gives each person a realistic-looking photo: an AI-generated synthetic face fetched at enroll/seed time, with an offline procedural fallback if there’s no internet connection (see Avatar Photos)

​
Where to go next

Quickstart

Get the server and UI running locally in a few minutes

Data Model

See how persons, NIN records, and BVN records relate

API Reference

Every endpoint, with request/response shapes

Avatar Photos

How test photos are generated