Passport Check

# Introduction

Used to verify a customer by passport number.

# Request Parameters

The following parameters are expected:

Field Description Type
search_type Must be PASSPORTCHECK String
score_type Must be PASSPORTCHECK String
identifier Passport number to verify String
consent Indicates whether the data owner has consented to identity verification 1 if yes 0 if no. String
consent_collected_by Name or identifier of the person who provided the data owner’s consent. String

Please find sample implementation on the left


# Response Parameters

The response returns passport verification details and a tracking request ID.

Field Description Type
success Whether the request succeeded Boolean
response_code HTTP-style status code returned by the service Number
message Result message String
data.first_name Customer first name (mask in UI if required) String
data.surname Customer surname (mask in UI if required) String
data.other_name Customer other name String
data.name Full name String
data.gender Gender String
data.dob Date of birth String
data.citizenship Citizenship String
data.id_number ID number String
data.passport_number Passport number (mask in UI if required) String
data.clan Clan String
data.ethnic_group Ethnic group String
data.family Family String
data.occupation Occupation String
data.pin PIN String
data.place_of_birth Place of birth String
data.place_of_live Place of residence String
data.reg_office Registration office String
data.date_of_issue Passport issue date String
data.date_of_expiry Passport expiry date String
data.valid Whether the passport is still valid Boolean
data.fingerprint_path Path to fingerprint image String
data.photo_path Path to photo image String
data.signature_path Path to signature image String
request_id Request identifier for tracking String

Below is a sample response. In UI displays, sensitive fields such as names and passport numbers may be masked.

{
  "success": true,
  "response_code": 200,
  "message": "Passport Details Fetched Successfully",
  "data": {
    "first_name": "C*****",
    "surname": "N*****",
    "other_name": "O*****",
    "name": "C***** O***** N*****",
    "gender": "M",
    "dob": "1998-01-13",
    "citizenship": "Kenyan",
    "id_number": "3691****",
    "passport_number": "BK7299**",
    "clan": "",
    "ethnic_group": "",
    "family": "",
    "occupation": "",
    "pin": "",
    "place_of_birth": "KAKAMEGA SOUTH\nDISTRICT - KAKAMEGA SOUTH\n",
    "place_of_live": "",
    "reg_office": "",
    "date_of_issue": "2024-06-07",
    "date_of_expiry": "2034-06-06",
    "valid": true,
    "fingerprint_path": null,
    "photo_path": null,
    "signature_path": null
  },
  "request_id": "112d94a8-d78a-451a-a48d-2e2ee33863ef"
}