Zimbabwe National ID

Verify a Zimbabwe National ID and fetch holder details from the national registry using the ID number.

Request

[GET]

{{baseURL}}/api/v1/zw/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
id_number	string	Zimbabwian National ID	required

Sample response

Response

{
    "entity": {
        "person_no": "451234561E45",
        "status": "A",
        "surname": "DOE",
        "first_name": "JOHN",
        "sex": "F",
        "date_of_birth": "1901-01-01",
        "date_of_death": "1961-01-01",
        "birth_place": "Earth"
    }
}

Response Fields

Field	Type	Description
entity	object	Contains the verification response data
entity.person_no	string	Unique person number from the national registry
entity.status	string	Status code of the record (e.g., A for active)
entity.surname	string	Surname of the individual
entity.first_name	string	First name of the individual
entity.sex	string	Sex of the individual (M or F)
entity.date_of_birth	string	Date of birth in YYYY-MM-DD format
entity.date_of_death	string	Date of death in YYYY-MM-DD format, if applicable
entity.birth_place	string	Place of birth