Verify A NIN Slip

Developing

POST

/api/v1/public/documentverification/nin-slip

Reads a NIN slip image and checks that the NIN and name you supplied match what appears on it. Extraction is AI-assisted while the match score is computed locally, so identical inputs always score identically. Results are cached for 24 hours by document type and payload. The wallet is debited on every call including cache hits, at your configured document verification fee less a 30% discount when your company supplies its own OpenAI or Azure OpenAI key. Note this endpoint returns the responseCode/responseMessage/responseData envelope, not the status/message/data one.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Verification completed. Check responseData.valid for the verdict — a 200 does not mean the document passed.

Bodyapplication/json

🟠400

🟠401

🔴502

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/public/documentverification/nin-slip' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "nin": "12345678901",
    "fullName": "Adaeze Okonkwo",
    "imageUrl": "https://cdn.example.com/docs/nin-slip.jpg"
}'

Response Example

200 - Example 1

{
    "responseCode": "00",
    "responseMessage": "Document verification completed.",
    "responseData": {
        "valid": true,
        "confidenceScore": 96.4,
        "reason": "Name and ID number match the document."
    }
}

Modified at 2026-08-06 11:58:31

Verify A National ID Card

Verify An International Passport