Skip to main content

Verify person identity using virtual NIN

POST /api/v1/Identity/verification/nin/virtual

Description​

This endpoint is used to verify a person's identity using their Virtual National Identification Number (NIN) which is obtained through a virtual registration process.

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 VirtualNinRequest schema.

URL: /api/v1/Identity/verification/nin/virtual

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/nin/virtual
    Request Body:
    {
    "virtual_nin_number": "123456789",
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-02-18T12:12:12.000Z",
    "address": "123 Main St, Springfield"
    }

Response:

    jsonCopy codeHTTP/1.1 200 OK
    {
    "virtual_nin_number": "123456789",
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-02-18T12:12:12.000Z",
    "address": "123 Main St, Springfield"
    }

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)​

    {
    "virtualNin": "<string>"
    }