World Airports API Guide

Welcome to the World Airports API! This guide will assist you in leveraging our API to access a wealth of airport information worldwide.

Introduction

The World Airports API provides developers with access to a vast repository of airport data, facilitating easy retrieval of airport details such as location, IATA and ICAO codes, elevation, and more. Whether you’re building a travel booking platform, flight tracker, or any aviation-related application, our API offers the necessary tools to enhance your user experience.

Key Features

• Comprehensive Database: Access detailed information about airports worldwide.
• Search Functionality: Find airports using search terms, IATA codes, or ICAO codes.
• Free Access: Enjoy unrestricted access to our API at no cost.
• Real-time Updates: Our database is regularly updated to ensure accuracy and relevance.

Base URL

All API requests are made to:

https://airports.p.rapidapi.com

Authentication

To use the World Airports API, you need to subscribe to the API on RapidAPI and obtain your API key. Include your API key in the headers of each request.

Endpoint Details

Airport Search

Endpoint: /v1/airports

Description: Search for airports using various criteria such as airport name, IATA, or ICAO codes.

Request Method: POST

Request Body:

{
    "search": "Singapore Changi International Airport"
}

Response:

[
    {
        "icao": "WSSS",
        "iata": "SIN",
        "name": "Singapore Changi International Airport",
        "city": "Singapore",
        "state": "North-East",
        "country": "SG",
        "elevation": 22,
        "lat": 1.3501900434,
        "lon": 103.9940032959,
        "tz": "Asia/Singapore",
        "ac": "SIN",
        "an": "Singapore Changi International Airport",
        "cn": "Singapore",
        "cc": "SG",
        "ct": "Singapore"
    }
]

Example Request

Here’s how to make a request to search for an airport:

curl -X POST 'https://airports.p.rapidapi.com/v1/airports' \
-H 'Content-Type: application/json' \
-H 'X-RapidAPI-Host: airports.p.rapidapi.com' \
-H 'X-RapidAPI-Key: YOUR_API_KEY' \
-d '{"search": "Singapore Changi International Airport"}'

Example Response

A successful response will return an array of airports matching the search criteria, each containing detailed information:

[
    {
        "icao": "WSSS",
        "iata": "SIN",
        "name": "Singapore Changi International Airport",
        "city": "Singapore",
        "state": "North-East",
        "country": "SG",
        "elevation": 22,
        "lat": 1.3501900434,
        "lon": 103.9940032959,
        "tz": "Asia/Singapore",
        "ac": "SIN",
        "an": "Singapore Changi International Airport",
        "cn": "Singapore",
        "cc": "SG",
        "ct": "Singapore"
    }
]

Understanding the Response

• icao: ICAO code of the airport.
• iata: IATA code of the airport.
• name: Name of the airport.
• city: City where the airport is located.
• state: State/Province where the airport is located.
• country: Country where the airport is located.
• elevation: Elevation of the airport.
• lat: Latitude coordinates of the airport.
• lon: Longitude coordinates of the airport.
• tz: Timezone of the airport.
• ac: Airport code.
• an: Airport name.
• cn: Country name.
• cc: Country code.
• ct: City name.

Error Handling

In case of errors, the API will return an appropriate error message in the response body. Handle these errors gracefully in your application.

Support

For any questions or issues, please visit our support page on RapidAPI or contact our support team.

Thank you for using the World Airports API! We look forward to seeing the innovative applications you develop with our service.