Skip to main content

Verify business identity using BVN without image

POST /api/v1/Identity/verification/bvn-no-image

Description​

This endpoint is used to verify a person's identity using their Bank Verification Number (BVN) without an image.

Headers: Accept-Language: optional, allows changing default response message language, type: string

Content-Type:

  • text/plain
  • application/json
  • text/json

ApiKey:

  • No API key required

Request Body:

  • An object of the BvnRequestNoImage schema.

URL: /api/v1/Identity/verification/bvn-no-image

Query Parameters:

  • None

params:*

  • version: string, required

Response: The response is a "Success" status with a code of 200.

Error Codes:

  • 400: Bad Request
  • 404: Resource not found
  • 500: Internal server error

Example:

bashCopy codePOST /api/v1/Identity/verification/bvn-no-image
Request Body:
    {
    "bvn_number": "12345678901",
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-02-18T12:12:12.000Z"
    }

Response:

jsonCopy codeHTTP/1.1 200 OK
    {
    "bvn_number": "12345678901",
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-02-18T12:12:12.000Z"
    }

Headers​

Accept-Language Change default response message language from English(en). Available languages fr,en Content-Type application/json

Accept text/plain

Body raw(json)​

    {
    "number": "<string>"
    }