LumiID API

NIN Verification API

Use this API to verify a user's identity using their National Identification Number (NIN). LumiID provides both Basic and Premium verification levels.

Basic NIN Endpoint

POST /api/v1/nin/basic/verify/

**Required Field**: nin

Premium NIN Endpoint

POST /api/v1/nin/premium/verify/

**Required Field**: nin

Returns additional bio and document image info

Sample Request

{ "nin": "12345678901" }

Sample Response (Basic)

{
  "status": "success",
  "message": "Verification successful",
  "data": {
    "first_name": "Emmanuel",
    "last_name": "Nzorov",
    "nin": "12345678901",
    "date_of_birth": "1999-07-12",
    "gender": "Male",
    "phone": "08012345678",
    "photo_url": null
  }
}

Sample Response (Premium)

{
  "status": "success",
  "message": "Premium verification successful",
  "data": {
    "first_name": "Emmanuel",
    "last_name": "Nzorov",
    "nin": "12345678901",
    "date_of_birth": "1999-07-12",
    "gender": "Male",
    "phone": "08012345678",
    "state_of_origin": "Benue",
    "lga": "Gboko",
    "photo_url": "https://cdn.lumiid.com/photos/emmanuel.jpg"
  }
}

⚠️ All test requests must use only the provided test NIN: 12345678901. Any other input will return an error in the sandbox environment.