List Airports - PayVessel

Retrieve the airport catalogue used by the flight API. Each airport object includes the airport code, display name, city, and country. Airport data is cached by PayVessel and refreshed periodically. The current refresh window is 7 days.

Usage

curl https://api.payvessel.com/vaas/api/v1/flight/airports \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_API_SECRET"

Response fields

Field	Type	Description
`status`	boolean	`true` when the request succeeds
`message`	string	Human-readable response message
`data`	array	Airport objects
`data[].airport_code`	string	IATA airport code
`data[].airport_name`	string	Airport display name
`data[].city_country`	string	Combined city and country label
`data[].city`	string	City
`data[].country`	string	Country

Example response

{
  "status": true,
  "message": "Airports retrieved successfully",
  "data": [
    {
      "airport_code": "LOS",
      "airport_name": "Murtala Muhammed International Airport (LOS)",
      "city_country": "Lagos, Nigeria",
      "city": "Lagos",
      "country": "Nigeria"
    },
    {
      "airport_code": "JFK",
      "airport_name": "John F. Kennedy International Airport (JFK)",
      "city_country": "New York, United States",
      "city": "New York",
      "country": "United States"
    }
  ]
}

API Reference

Full request and response schema