Verify people.
And businesses.
One API for four services on Nigerian identity and company records. Every rate is published, and you pay only when a check resolves.
Rates in naira, per resolved call. How billing works
POST /v1/identity/bvn/details
identity:bvn_details60 a minute
Authorization: Bearer $SEMPERID_TEST_KEY Idempotency-Key: signup-2291{ "bvn": "22222222220" }
- Outcome
- Successful verification
- Webhook
verification.completed- Charged
- ₦100.00Published rate
BVN Full Details: Successful verification. Charged ₦100.00.
Pay for answers.
Never for outages.
A match, a mismatch and no record are all answers, billed at the published rate. When an upstream source fails, you pay nothing.
See every rateBilled per resolved call
Each answer is charged from your prepaid wallet and recorded in its ledger.
Provider failures cost ₦0
A source that is unavailable, times out or returns an error is never billed.
Retries are safe
Send an Idempotency-Key and a settled result is safe to retry.
Three headers and a JSON body.
Every check is a POST from your backend to api.semperid.ng. Results come back in the response, and as signed webhook events when you subscribe to them.
Every request
Authorization: Bearer <your key>Sent from your server, scoped to the checks it may call.Content-Type: application/jsonThe check’s fields, as a JSON body.Idempotency-Key: <your value>Makes a settled result safe to retry.
- Interface
- REST over HTTPS, with JSON bodies
- Rate limit
- 60 requests a minute, per check
- Records
- Every request logged in your console, with masked payloads
Every webhook
SemperID-Event-IdIdentifies the event.SemperID-TimestampWhen it was signed. Reject anything older than 300 seconds.SemperID-SignatureHex HMAC-SHA256 of {timestamp}.{raw_body}, with your signing secret.
- Immediately
- 1 minute
- 5 minutes
- 30 minutes
- 2 hours
- 6 hours
- 24 hours
Know the customer. And the business behind the account.
The checks teams reach for at each moment. Mix any of the four in one workflow, under one key.
| Check group | People | Business and finance | ||
|---|---|---|---|---|
| Onboarding moment | BVN details | NIN details | Passport | CAC |
| Opening an accountFintech and payments | Typical check | Typical check | ||
| Approving a loanLending | Typical check | Typical check | ||
| Onboarding a sellerMarketplaces | Typical check | Typical check | ||
| Activating a driverMobility and logistics | Typical check | |||
| Hiring a candidateHR and workforce | Typical check | Typical check | ||
| Opening a business accountB2B and SaaS platforms | Typical check | Typical check | ||
Opening an account
Fintech and payments
Approving a loan
Lending
Onboarding a seller
Marketplaces
Activating a driver
Mobility and logistics
Hiring a candidate
HR and workforce
Opening a business account
B2B and SaaS platforms
From test key to live traffic.
Step 1: Build against the sandbox
Register in the console, create a test key and scope it to the checks you need. Every check answers six published test values, one for each outcome.
- Test keys, shown once
- Scopes per check
- Request log with masked payloads
Step 2: Verify your business
Submit your KYB application and evidence in the console, turn on two-factor sign-in and bring in your team.
- KYB application and document upload
- Authenticator sign-in with recovery codes
- Team invitations and roles
Step 3: Fund and go live
Create a live key once your business is approved, then top up a prepaid wallet by bank transfer.
- Your own virtual account for top-ups
- An immutable ledger of every charge
- Usage and billing export as CSV
- Low-balance alerts by webhook
Start with one endpoint.
Build from there.
Create an account, make a test key and call any of the four services against the sandbox.