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", "extended").
nin	string	No	The National Identification Number (NIN).
faceImage	string	Yes	The base64-encoded image string for face verification.

Sample Request

curl

curl -X 'POST' \
  'https://api.sourceid.tech/v1/api/verification/nin-face' \
  -H 'accept: application/json' \
  -H 'x-api-key: {API-KEY}' \
  -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": {
          "faceMatch": {
              "confidence": 1,
              "message": "Face Match"
          },
          "ninData": {
              "names": {
                  "firstName": "OLUWASUNMISOLA",
                  "lastName": "OMISORE",
                  "middleName": "OYINDAMOLA",
                  "title": null
              },
              "personalData": {
                  "dateOfBirth": "17-09-2011",
                  "gender": "f",
                  "religion": null,
                  "height": null,
                  "educationLevel": null,
                  "employmentStatus": null
              },
              "address": {
                  "residenceAddress": "NO. 10 GRACE LAND ESTATE ELEBU",
                  "residenceTown": null,
                  "residenceLga": null,
                  "residenceState": "Oyo",
                  "residenceStatus": null
              },
              "contact": {
                  "phoneNumber": "08069948650"
              },
              "identification": {
                  "nin": "52938810312",
                  "vnin": null,
                  "centralId": null,
                  "userId": null,
                  "trackingId": "0R3DLOMSUQKZ3XF"
              },
              "origin": {
                  "birthCountry": "nigeria",
                  "birthState": null,
                  "birthLga": null,
                  "originState": "Osun",
                  "originLga": "Ife East",
                  "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)"
        }
    }