Fetch Verification (Sync)

Fetch Verification (Sync)

POST {{BASE_URL}}/api/v1/sync/verification

This endpoint allows you to verify a customer details synchronously.

Headers

Name	Type	Description
Authentication	string	Authentication token to track down who is emptying our stocks.

Request Body

Name	Type	Description
identifier_type*	String	The identifier type being used for the verification (national_id or passport_no)
identifier*	String	Identifier value

200: OK Verification successfully retrieved. (NATIONAL ID)

{
    "status": 200,
    "message": "Verification data successfully fetched",
    "data": {
        "national_id": "12431678",
        "full_name": "JANE DOE CURTIS",
        "other_names": "JANE DOE",
        "surname": "CURTIS",
        "citizenship": "",
        "clan": "",
        "date_of_birth": "",
        "date_of_death": "",
        "ethnic_group": "",
        "family": "",
        "first_name": "JANE",
        "gender": "F",
        "occupation": "UNEMPLOYED",
        "other_name": "DOE",
        "photo": "base64 string",
        "signature": "base64 string",
        "place_of_birth": "",
        "place_of_death": "",
        "place_of_live": "CHIEF\nNGUNGI\nKANGONDE\nLOCATION - MASINGA\nDIVISION - MASINGA\nDISTRICT - MASINGA\n",
        "date_of_issue": "9/25/2014 12:00:00 AM",
        "reg_office": "",
        "serial_number": "124316781",
        "idnumber": "12431678"
      }
}

200: OK Verification successfully retrieved. (PASSPORT)

{
    "status": 200,
    "message": "Verification data successfully fetched",
    "data": {
        "full_name": "JANE DOE CURTIS",
        "other_names": "JANE DOE",
        "citizenship": "Kenyan",
        "clan": "",
        "date_of_birth": "1/2/1999 12:00:00 AM",
        "date_of_death": "",
        "ethnic_group": "",
        "family": "",
        "fingerprint": "",
        "first_name": "JANE",
        "gender": "F",
        "occupation": "STUDENT",
        "other_name": "DOE",
        "photo_from_passport": "base64 string",
        "place_of_birth": "",
        "place_of_death": "",
        "place_of_live": "CHEIF\nENCHORO\nENCHORO\nLOCATION - BOSAMARO MASABA\nDIVISION - NYAMIRA\nDISTRICT - NYAMIRA\n\n",
        "signature": "",
        "surname": "CURTIS",
        "date_of_birth_from_passport": "",
        "date_of_expiry": "4/26/2031 12:00:00 AM",
        "date_of_issue": "4/27/2021 12:00:00 AM",
      }
}

JSON Payload - National ID

{ 
 "identifier_type": "national_id", 
 "identifier": "12431678",
 "first_name": "Jane",
 "last_name": "Doe",
}

JSON Payload - Passport

{ 
 "identifier_type": "passport_no", 
 "identifier": "AK078R474",
 "first_name": "Jane",
 "last_name": "Doe",
}