Skip to main content
POST
Document Verification — Nigeria National ID
Verify a customer’s Nigerian National Identification Number slip or card by uploading a photo — no manual NIN entry required. OCR extraction plus a required face match against a selfie — no liveness check (no video, no blink/motion challenge).
This is a two-sided document — supply both document_front and document_back for the most complete extraction.
selfie_image is required — the face extracted from the document is compared against it. This is a still-image comparison (not liveness).

Endpoint

Request

Headers

Body Parameters

document_type and country are not needed — this endpoint is already scoped to Nigerian National ID.

Example

Response

200 OK

Extra Fields — the newer, one-sided NIN slip/card has no fields beyond what’s listed above. The older, two-sided card prints more (occupation, state, lga, ward, height, blood_group, plus several back-side fields) — these come back in extra_fields when present, and are simply absent for the newer format rather than sent as null.
Face Match Notes — if the comparison service itself fails, attempted reflects whether a comparison was actually run and verified comes back null with a reason field explaining why — this is different from verified: false, which means the comparison ran and the faces didn’t match. A face-match problem never blocks the underlying document data — the rest of data is still returned.

400 Bad Request

Returned for invalid input, or when the document fails OCR’s own quality checks (blurry, wrong document type, glare, etc.).

401 Unauthorized

For a full list of error codes, see the Error Codes reference.

Authorizations

x-access-token
string
header
required

Your Adhere API secret key

Body

multipart/form-data
document_front
file
required

Front of the NIN slip/card. JPG or PNG, max 5MB.

document_back
file

Back of the card. Optional, but recommended — extraction may be less complete without it.

selfie_image
file

A selfie to compare against the face extracted from the document. JPG or PNG, max 5MB. Required.

Response

Document details extracted successfully

status
string
Example:

"success"

data
object
message
string
Example:

"Document details retrieved successfully"