Speedmap documentation
Verify identities (NIN, BVN, faces, CAC businesses, bank accounts and fraud signals) through one REST API and an MCP server.
Speedmap is an AI-powered identity verification platform for KYC, KYB, AML and fraud prevention. One API key gives you a single normalized response for every check, whether it is answered by NIMC (through the NIMC-designated verification channel), NIBSS or the CAC register.
Create an account and your workspace starts in test mode: sk_test_ keys return deterministic results for every outcome and are never billed. When you are ready, complete the compliance review and we switch the workspace live.
Every request is tied to a declared purpose, consent is satisfied before anything reaches a provider, and you choose how much personal data leaves the platform. AI assistants get assertions only: a NIN never enters a model's context window.
Each product is one POST endpoint. Prices are indicative, in naira, per billed check on live keys. Test-mode calls are always free. See pricing.
| Product | Endpoint | Availability | Indicative price |
|---|---|---|---|
POST /v1/verify/nin | Available | ₦100.00 | |
POST /v1/verify/bvn | Available | ₦100.00 | |
POST /v1/verify/face | Available | ₦150.00 | |
POST /v1/verify/phone | Available | ₦50.00 | |
POST /v1/verify/business | Available | ₦500.00 | |
POST /v1/verify/account | Available | ₦25.00 | |
POST /v1/signals | Available | ₦200.00 | |
POST /v1/verify/passport | Preview (test mode only) | ₦200.00 | |
POST /v1/verify/drivers-license | Preview (test mode only) | ₦200.00 | |
POST /v1/verify/voters-card | Preview (test mode only) | ₦150.00 |
Ways to use Speedmap
| Access model | Who it is for | How |
|---|---|---|
| REST API | Fintechs, banks, lenders, telcos, mobility platforms, employers, insurers | Integrate verification into your own onboarding and compliance flows. |
| MCP server | Compliance teams, analysts, developers | Verify inside ChatGPT, Claude, Cursor and VS Code through Speedmap Connect. |
| Dashboard | Operations and compliance staff | Run single checks, upload CSV files for bulk jobs, manage keys and webhooks. |
Base URL
All API requests go to one origin. The key prefix, not the URL, selects test mode or live:
http://localhost:4000The remote MCP server lives at http://localhost:4000/mcp.
Core concepts
- Assertions, not records. Responses lead with
status,matchand a maskedsummary. The full normalized record (data) is returned only to full-tier accounts on the REST API. See Response shaping. - Purpose codes. Identity checks carry a
reason, one of the 38 NIMC purpose codes. A misdeclared purpose is a licence-level violation, so the list is enforced before a provider is called. - Consent first. Each method has a consent mechanism: your attestation, an in-person selfie, a NINAuth share code, or a Consent Hub request approved by the data subject.
- Retries are safe. Send an
Idempotency-Keyand a retried request returns the original result and is never billed twice.
For AI agents and tools
Machine-readable entry points to these docs and the API:
/llms.txt: a short index of the docs for language models./llms-full.txt: the full documentation in one file./openapi.json: the OpenAPI 3.0 description of the API./.well-known/mcp.json: the MCP server manifest.- Every docs page is available as Markdown: add
.mdto its URL, for example/docs/quickstart.md.
Questions? Email developers@speedmap.ng. This page is also available as Markdown.