Get Airports

Returns a list of all airports available for booking. Results are cached and refreshed periodically. Use this endpoint to build a search UI or validate IATA codes before calling Search Flights. You can filter by passing a search query parameter — the API will match against the airport name, city name, or IATA code (case-insensitive).

Usage

curl https://api.payvessel.com/pms/api/external/request/flights/airports/ \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_API_SECRET"

With search filter:

curl "https://api.payvessel.com/pms/api/external/request/flights/airports/?search=lagos" \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_API_SECRET"

Query parameters

Parameter	Type	Required	Description
`search`	string	No	Filter by airport name, city, or IATA code

Response

Field	Type	Description
`status`	boolean	`true` on success
`message`	string	Human-readable message
`data`	array	List of airport objects
`data[].IATA`	string	3-letter IATA airport code
`data[].AirportName`	string	Full airport name
`data[].CityName`	string	City the airport serves
`data[].CountryCode`	string	ISO 2-letter country code

Example response

{
  "status": true,
  "message": "Airports retrieved successfully",
  "data": [
    {
      "IATA": "LOS",
      "AirportName": "Murtala Muhammed International Airport",
      "CityName": "Lagos",
      "CountryCode": "NG"
    },
    {
      "IATA": "ABV",
      "AirportName": "Nnamdi Azikiwe International Airport",
      "CityName": "Abuja",
      "CountryCode": "NG"
    },
    {
      "IATA": "LHR",
      "AirportName": "Heathrow Airport",
      "CityName": "London",
      "CountryCode": "GB"
    }
  ]
}

API Reference

Full request/response details and Try it

Overview Search Flights

Getting started

Use cases

API Basics

Accept Payment

Transfers

Wallets

Virtual Accounts

Issuing

Identity Verification

Value Added Services

Flight Booking

Webhook

Usage

Query parameters

Response

Example response

API Reference

​Usage

​Query parameters

​Response

​Example response

API Reference

Usage

Query parameters

Response

Example response