NIN Verification

Verify identity details using National Identification Number (NIN), phone number, or demographic details.

Verify by NIN

Request Body:

{
                                    "nin": "12345678901",
                                    "provider": "v2" // Optional: "v1", "v2", "v3"
                                }

Sample Success Response:

{
                                    "status": "success",
                                    "message": "Verification Successful",
                                    "data": {
                                        "firstname": "JOHN",
                                        "middlename": "DOE",
                                        "surname": "JEN",
                                        "telephoneno": "",
                                        "birthdate": "28-08-2003",
                                        "residence_state": "Imo",
                                        "residence_town": "",
                                        "residence_AdressLine1": "NEW ABIA STREET",
                                        "residence_lga": "Ohaji/Egbema",
                                        "birthcountry": "****",
                                        "birthstate": "****",
                                        "birthlga": "****",
                                        "country": "",
                                        "gender": "m",
                                        "image": "/9j/4AAQSkZJRgA ...",
                                        "nin": "8888888835",
                                        "trackingId": "BY8756789087",
                                        "heigth": "****",
                                        "maritalstatus": "****",
                                        "nok_address1": "****",
                                        "nok_firstname": "****",
                                        "nok_lga": "****",
                                        "nok_surname": "****",
                                        "nok_town": "****",
                                        "nspokenlang": "****",
                                        "pmiddlename": "****",
                                        "profession": "****",
                                        "religion": "****",
                                        "residencestatus": "****",
                                        "self_origin_lga": "Ohaji/Egbema",
                                        "self_origin_place": "AWARRA OHAJI",
                                        "self_origin_state": "Imo"
                                    },
                                    "meta": {
                                        "amount": 200,
                                        "balance_before": 4900,
                                        "balance_after": 4700,
                                        "date": "31-01-2026 21:50:27"
                                    }
                                }

Verify by Phone

{
                                    "phone": "08012345678"
                                }

Sample Response:

{
                                    "status": "success",
                                    "message": "Verification Successful",
                                    "data": {
                                        "firstName": "JOHN",
                                        "middleName": "DOE",
                                        "lastName": "JEN",
                                        "mobile": "",
                                        "dateOfBirth": "28-08-2003",
                                        "gender": "m",
                                        "address": {
                                            "state": "ABIA",
                                            "town": "",
                                            "addressLine": "NEW ABIA STREET",
                                            "lga": "ABIA"
                                        },
                                        "birthCountry": "****",
                                        "birthState": "****",
                                        "birthLGA": "****",
                                        "title": null,
                                        "centralID": null,
                                        "educationallevel": null,
                                        "employmentstatus": null,
                                        "height": null,
                                        "maritalstatus": "****",
                                        "nok_address1": "****",
                                        "nok_firstname": "****",
                                        "photo": "/9j/4AAQSkZJRg ...",
                                        "idNumber": "8888888835",
                                        "trackingId": "BY8756789087"
                                    },
                                    "meta": {
                                        "amount": 200,
                                        "balance_before": 4700,
                                        "balance_after": 4500,
                                        "date": "31-01-2026 21:51:58"
                                    }
                                }

Demographic Search

{
                                    "firstname": "John",
                                    "lastname": "Doe",
                                    "dob": "1990-01-01",
                                    "gender": "male"
                                }

IPE Clearance

Submit a request for IPE (Identity Profile Entry) clearance.

Request Body:

{
                                    "tracking": "1234567890",
                                    "type": "get-old-tracking-id" 
                                }

Sample Response (Auto):

{
                                    "status": "success",
                                    "message": "Clearance successful",
                                    "data": {
                                        "reference": "IPE-A1B2C3D4",
                                        "tracking_id": "1234567890",
                                        "type": "get-old-tracking-id",
                                        "amount": 500.00,
                                        "balance_before": 4900.00,
                                        "balance_after": 4400.00,
                                        "date": "31-01-2026 20:35:10"
                                    }
                                }

Check Status

Verify the status of a verification request using the reference code.