Verified

The Verified Developer Hub

Welcome to the Verified developer hub.
With a variety of services at your disposal including NIN, FRSC, International passport, Voters card, Tin and BVN, you can ensure real-time identity verification with utmost compliance.
You'll find comprehensive guides and documentation to help you start working with Verified as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Guides

Conditions for response

🚦 Conditions for Response

  • If any required request parameters is null, you will get a response, 400 Bad request...
  • If email is invalid, you'll get a response 400, Bad request...
  • If userid is not authenticated, you'll get a response 401, Unauthorised...
  • If Apikey doesn’t have access, you'll get a response 401, Unauthorised...
  • If client/user has exhausted/insufficient balance in the wallet, you'll get a response 402, Payment required...

📈 Response Types

We have made appropriate responses available when you make a request to the Verified API.

These are typically the Responses you might get on Verified.ng and what they mean:

Ok 200 : The request has returned successful, Validation passed.

Accepted 202 : Your request was received and handled successfully. However it failed validation.

Bad Request 400 : The request could not be understood by the server due to malformed syntax, do not repeat the request without modifications.

Unauthorized 401 : The request requires user authentication. You may repeat request with authenticated tokens.

Payment Required 402 : Generally infers an insufficient balance in your user wallet for the service invocation requested.

Expectation Failed 417 : Oops! Something went wrong in your service invocation handling. Please reply at a later time.

Internal Server Error 500 : The server encountered an unexpected condition which prevented it from fulfilling the request.

Service Unavailable 503 : The server is currently unable to handle the request due to the params not properly parsing. This is most likely a temporary issue, please try again at a later time.

Updated 10 months ago


Conditions for response


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.