IATAGeo API Documentation

Convert geographic coordinates to airport codes (IATA/ICAO) and vice versa. Fast, reliable, and free API for aviation data.

Quickstart Try It Now

Getting Started

Start using the IATAGeo API in seconds. No authentication required. Just make HTTP requests to our endpoints.

Base URL
https://www.iatageo.com/v2

The API provides three main endpoints for working with airport data:

  • • Nearest Airport - Find the closest airport to any coordinates
  • • IATA Lookup - Get airport details by 3-letter IATA code
  • • ICAO Lookup - Get airport details by 4-letter ICAO code

Guides

Quickstart

Get up and running with IATAGeo API in under 5 minutes.

Errors

Learn about error codes and how to handle them gracefully.

Try It Now

Test the API endpoints directly in your browser.

Support

Get in touch for questions, feedback, or support.

Resources

GET /v2/airports/nearest

Find the nearest airport to given geographic coordinates.

Query Parameters

Parameter Required Description
lat Yes Latitude (-90 to 90)
lng Yes Longitude (-180 to 180)
types No Airport types (comma-separated): large_airport, medium_airport, small_airport
range No Search range in meters (default: 500000)

Example Response

{
  "success": true,
  "data": {
    "name": "Presidente Juscelino Kubitschek International Airport",
    "iataCode": "BSB",
    "icaoCode": "SBBR",
    "coordinates": {
      "latitude": -15.8711,
      "longitude": -47.918625
    },
    "distanceMeters": 127763
  },
  "meta": {
    "version": "v2",
    "timestamp": "2026-01-30T12:00:00.000Z"
  }
}
GET /v2/airports/iata/:code

Get airport information by IATA code (3-letter code).

Path Parameters

Parameter Description
code 3-letter IATA code (e.g., BSB, JFK, LAX)

Example Response

{
  "success": true,
  "data": {
    "name": "Presidente Juscelino Kubitschek International Airport",
    "iataCode": "BSB",
    "icaoCode": "SBBR",
    "coordinates": {
      "latitude": -15.8711,
      "longitude": -47.918625
    }
  },
  "meta": {
    "version": "v2",
    "timestamp": "2026-01-30T12:00:00.000Z"
  }
}
GET /v2/airports/icao/:code

Get airport information by ICAO code (4-letter code).

Path Parameters

Parameter Description
code 4-letter ICAO code (e.g., SBBR, KJFK, KLAX)

Example Response

{
  "success": true,
  "data": {
    "name": "Presidente Juscelino Kubitschek International Airport",
    "iataCode": "BSB",
    "icaoCode": "SBBR",
    "coordinates": {
      "latitude": -15.8711,
      "longitude": -47.918625
    }
  },
  "meta": {
    "version": "v2",
    "timestamp": "2026-01-30T12:00:00.000Z"
  }
}

Errors

All errors follow a consistent format with meaningful error codes to help you handle issues gracefully.

Error Codes

Code HTTP Status Description
INVALID_COORDINATES 400 Missing or invalid lat/lng
INVALID_IATA_CODE 400 IATA code must be 3 letters
INVALID_ICAO_CODE 400 ICAO code must be 4 letters
NOT_FOUND 404 No airport found
DATABASE_ERROR 500 Internal server error

Example Error Response

{
  "success": false,
  "error": {
    "code": "INVALID_COORDINATES",
    "message": "Missing or invalid coordinates. Both lat and lng query parameters are required."
  },
  "meta": {
    "version": "v2",
    "timestamp": "2026-01-30T12:00:00.000Z"
  }
}

Try It Now

Test the API directly from your browser. Select an endpoint and provide the required parameters.

Legacy Endpoints

The original endpoints (/getCode, /getLatLng, etc.) are still available for backward compatibility but are deprecated. Please migrate to the /v2 API for better error handling and consistent responses.

Get in Touch

Have questions, suggestions, or need help? Feel free to reach out.

LinkedIn Email

If you find this API useful, consider supporting its development: