Lookup NIN

Verify a Ugandan National ID and fetch holder details from the national registry using the NIN.

Request

[GET]

{{baseUrl}}/api/v1/ug/kyc/nin

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query parameter

Parameter	Type	Description	Required
nin *	string	National ID Number (NIN)	required
first_name	string	The first name of the document holder	optional
last_name	string	The last name of the document holder	optional

Sample response

Response

{
  
    "entity": {
        "id_number": "CM123456789AB",
        "first_name": "John",
        "last_name": "Doe",
        "middle_name": "Anon",
        "date_of_birth": "1990-01-01"
    }

  
}

Response Fields

Field	Type	Description
entity	object	Contains the verification response data
entity.id_number	string	National ID Number (NIN) of the individual
entity.first_name	string	First name of the individual
entity.last_name	string	Last name of the individual
entity.middle_name	string	Middle name of the individual
entity.date_of_birth	string	Date of birth in YYYY-MM-DD format