International Passport

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/verify-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.
identity	string	Yes	A unique identifier for the user. .
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.

Example Request Body

{
    "country": "NGA",
    "reference": "0122333444455555",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "passportNumber": "A00400000",
    "lastName": "Doe"
}

Sample Request

curl

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",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "passportNumber": "A00400000",
    "lastName": "Doe"
    }'

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)"
    }
}