Skip to content

Verify NIN with Face Biometric

This endpoint allows you to verify the validity of a National Identification Number (NIN) using face biometrics.

Endpoint: POST {baseurl}/v1/api/verification/nin-face

Request Body

Parameter Type Required Description
country string Yes The country code (e.g., "NGA" for Nigeria).
reference string Yes A unique reference for the verification request.
identity string Yes A unique identifier for the verification request.
verificationLevel string No The level of verification to perform (e.g., "basic").
nin string No The National Identification Number (NIN).
faceImage string Yes The base64-encoded image string for face verification.

Sample Request

curl -X POST "https://api.sourceid.tech/v1/api/verification/nin-face" \
-H "accept: application/json" \
-H "x-api-key: sk_live_v1_2GndGZyB298zcU802hgze1ltu8nCEd" \
-H "Content-Type: application/json" \
-d '{
    "country": "NGA",
    "reference": "012233312e444455555",
    "identity": "67f6050e03418e0428005cea",
    "verificationLevel": "basic",
    "nin": " ",
    "faceImage": "base64_encoded_image_string"
    }'

Sample Response

{
    "status": true,
    "responseCode": "00",
    "statusCode": "200",
    "message": "NIN with face verification successful",
    "data": {
    "ninData": {
        "names": {
        "firstName": "",
        "lastName": "",
        "middleName": "",
        "title": null
        },
        "personalData": {
        "dateOfBirth": "",
        "gender": "",
        "religion": null,
        "height": null,
        "educationLevel": null,
        "employmentStatus": null
        },
        "address": {
        "residenceAddress": "",
        "residenceTown": null,
        "residenceLga": null,
        "residenceState": "",
        "residenceStatus": null
        },
        "contact": {
        "phoneNumber": ""
        },
        "identification": {
        "nin": "",
        "vnin": null,
        "centralId": null,
        "userId": null,
        "trackingId": ""
        },
        "origin": {
        "birthCountry": "",
        "birthState": null,
        "birthLga": null,
        "originState": "",
        "originLga": "",
        "originPlace": null
        },
        "documents": {},
        "nextOfKin": [
        {}
        ],
        "parents": {
        "names": {
            "firstName": null,
            "lastName": null,
            "middleName": null
        }
        }
    }
    },
    "meta": {
    "statusCode": "200",
    "isValid": true,
    "timeStamp": "Wed Apr 23 2025 06:57:15 GMT+0000 (Coordinated Universal Time)"
    }
}

{
  "status": true,
  "responseCode": "00",
  "statusCode": "200",
  "message": "NIN with face verification successful",
  "data": {
    "ninData": {
      "names": {
        "firstName": "",
        "lastName": "",
        "middleName": "",
        "title": null
      },
      "personalData": {
        "dateOfBirth": "",
        "gender": "",
        "religion": null,
        "height": null,
        "educationLevel": null,
        "employmentStatus": null
      },
      "address": {
        "residenceAddress": "",
        "residenceTown": null,
        "residenceLga": null,
        "residenceState": "Oyo",
        "residenceStatus": null
      },
      "contact": {
        "phoneNumber": ""
      },
      "identification": {
        "nin": "",
        "vnin": null,
        "centralId": null,
        "userId": null,
        "trackingId": ""
      },
      "origin": {
        "birthCountry": "",
        "birthState": null,
        "birthLga": null,
        "originState": "",
        "originLga": "",
        "originPlace": null
      },
      "documents": {
        "photo": " ",
        "signature": null
      },
      "nextOfKin": [
        {}
      ],
      "parents": {
        "names": {
          "firstName": null,
          "lastName": null,
          "middleName": null
        }
      }
    }
  },
  "meta": {
    "statusCode": "200",
    "isValid": true,
    "timeStamp": "Wed Apr 23 2025 07:01:09 GMT+0000 (Coordinated Universal Time)"
  }
}