Integration Guide

Overview

Our Int'l Passport Lookup service enables you to verify detailed information about an international passport. This guide will walk you through the process of integrating this service into your application, allowing you to retrieve important passport details seamlessly.

Prerequisites

Before you begin integrating the Int'l Passport Lookup service, make sure you have the following:

Sign up on the Mono Dashboard ➡
Create an App and fetch the generated Secret Key ➡

With these prerequisites in place, you're ready to proceed with integrating the Int'l Passport Lookup service into your application using the steps outlined below.

Step 1: Make a Passport Lookup Request

To retrieve information about an international passport, send a POST request to the following endpoint:

POST https://api.withmono.com/v3/lookup/passport

Request Body Parameters

passport_number (required): Provide the passport number associated with the document.
last_name (required): Provide the last name as it appears on the passport document.

Include these two parameters in the request body to specify the passport number and last name for the lookup.

Request Headers

Include the following header in your request for authentication:

mono-sec-key (required): Your Mono secret key.

cURL Sample Request

curl -X POST \
  -H "Content-Type: application/json" \
  -H "mono-sec-key: YOUR_MONO_SECRET_KEY" \
  -d '{
    "passport_number": "PASSPORT_NUMBER",
    "last_name": "LAST_NAME_ON_PASSPORT"
  }' \
  https://api.withmono.com/v3/lookup/passport

Step 2: Process the Response

If the passport lookup request is successful, you will receive the following response:

{
  "status": "successful",
  "message": "Intl. Passport Lookup Successful",
  "data": {
    "number": "123456",
    "reference_id": "998877",
    "issued_date": "20/05/2020",
    "expiry_date": "19/05/2025",
    "document_type": "Standard Passport",
    "issued_at": "IKOYI, LAGOS",
    "first_name": "ADAM",
    "last_name": "SMITH",
    "middle_name": "AJAYI",
    "dob": "25/11/1994",
    "gender": "Male",
    "photo": "data:image/jpg;base64,/9j/4AAQSkZJ...Jsv/9k=",
    "signature": "data:image/jpg;base64,/9j/4AAQSkZJ...Jsv/9k=",
    "mobile": ""
  },
  "number": "A12345678"
}

The response contains detailed information about the international passport, including the passport number, reference ID, issued date, expiry date, document type, issued location, name details, date of birth, gender, photo, signature, and mobile number.