Errors

When something goes wrong we return a clear status code and error code.

StatusCodeMeaning
400invalid_ninThe NIN is not 11 digits.
401invalid_api_keyThe key is missing, wrong or revoked.
402insufficient_balanceTop up your wallet and try again.
403not_subscribedYour business has no active subscription to this verification. Subscribe in the dashboard and wait for approval. Test keys never need one.
404nin_not_foundNo record matches this NIN.
429rate_limitedToo many requests. Slow down and retry.
502provider_unavailableWe could not complete the check right now. Retry shortly. You are not charged.