National Identification Number (NIN) with Face Biometric Verification

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.
`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.
`customer`	`string`	No	ID of the customer (optional).
`verificationGroup`	`string`	No	ID of the verification group (optional).

Sample Request

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",
  "verificationLevel": "basic",
  "nin": " ",
  "faceImage": "base64_encoded_image_string",
  "customer": "6791457be570f7f292f1fe23",
  "verificationGroup": "6791457be570f7f292f1fe23"
}'

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)"
        }
    }