International Passport Verification

This endpoint is used to verify the details of an international passport. It requires the passport number and the last name of the passport holder.

Endpoint: POST {baseurl}/v1/api/verification/international-passport

Request Body

Field Name	Type	Required	Description
`country`	string	Yes	The country code of the passport. Example: `NGA`. (Support: Nigeria, Kenya and Ghana)
`reference`	string	Yes	A unique reference for the verification request.
`verificationLevel`	string	Yes	The level of verification to perform.
`passportNumber`	string	Yes	The passport number to verify. .
`lastName`	string	Yes	The last name of the passport holder.
`image`	string	Yes	A base64-encoded string of the document image.
`customer`	string	No	ID of the customer (optional).
`verificationGroup`	string	No	ID of the verification group (optional).

Supported Countries

Nigeria (Country Code: NGA)
Ghana (Country Code: GHA)
Kenya (Country Code: KEN)

Example Request Body

{
    "country": "NGA",
    "reference": "0122333444455555",
    "verificationLevel": "basic",
    "passportNumber": "A00400000",
    "lastName": "Doe",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
}

Sample Request

curl -X POST "{baseurl}/v1/api/verification/international-passport" \
-H "Content-Type: application/json" \
-H "x-api-key: {API-KEY}" \
-d '{
    "country": "NGA",
    "reference": "0122333444455555",
    "verificationLevel": "basic",
    "passportNumber": "A00400000",
    "lastName": "Doe",
    "customer": "6791457be570f7f292f1fe23",
    "verificationGroup": "6791457be570f7f292f1fe23",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
    }'

Sample Response

{
    "status": true,
    "responseCode": "00",
    "statusCode": "200",
    "message": "International Passport verification successful",
    "data": {
        "names": {
            "firstName": "John",
            "lastName": "Doe",
            "middleName": "Smith"
        },
        "personalData": {
            "dateOfBirth": "1990-01-01",
            "gender": "Male"
        },
        "contact": {
            "phoneNumber": "08012345678"
        },
        "identification": {
            "passportNumber": "A00400000"
        },
        "documents": {
            "photo": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
            "signature": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
        },
        "issuance": {
            "issuedAt": "LAGOS",
            "issuedDate": "2021-06-04",
            "expiryDate": "2026-06-03"
        }
    },
    "meta": {
        "statusCode": "200",
        "isValid": true,
        "timeStamp": "Thu Apr 24 2025 12:27:01 GMT+0000 (Coordinated Universal Time)"
    }
}