Errors
When something goes wrong we return a clear status code and error code.
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_nin | The NIN is not 11 digits. |
| 401 | invalid_api_key | The key is missing, wrong or revoked. |
| 402 | insufficient_balance | Top up your wallet and try again. |
| 403 | not_subscribed | Your business has no active subscription to this verification. Subscribe in the dashboard and wait for approval. Test keys never need one. |
| 404 | nin_not_found | No record matches this NIN. |
| 429 | rate_limited | Too many requests. Slow down and retry. |
| 502 | provider_unavailable | We could not complete the check right now. Retry shortly. You are not charged. |
