IATAGeo API

https://www.iatageo.com/
Admin
IATAGeo API is a free service that converts geographic coordinates to airport codes (IATA/ICAO) and...
Tokens:2,073
Snippets:13
Trust Score:5.3
Update:5 months ago
Show doc for...
Tokens:
Raw
### Example Error Response

Source: https://www.iatageo.com/

This is an example of an error response from the API, indicating an issue with invalid coordinates.

```json
{
  "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"
  }
}
```

--------------------------------

### Nearest Airport Example Response

Source: https://www.iatageo.com/

This is an example response for the nearest airport endpoint, showing airport details and distance.

```json
{
  "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"
  }
}
```

--------------------------------

### IATA Code Lookup Example Response

Source: https://www.iatageo.com/

This is an example response for the IATA lookup endpoint, returning airport details based on a 3-letter IATA code.

```json
{
  "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 Airport by IATA Code

Source: https://www.iatageo.com/

Retrieve detailed information about an airport using its 3-letter IATA code.

```APIDOC
## GET /v2/airports/iata/:code

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

### Method
GET

### Endpoint
/v2/airports/iata/:code

### Parameters
#### Path Parameters
- **code** (string) - Required - 3-letter IATA code (e.g., BSB, JFK, LAX)

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains airport details.
  - **name** (string) - The name of the airport.
  - **iataCode** (string) - The 3-letter IATA code.
  - **icaoCode** (string) - The 4-letter ICAO code.
  - **coordinates** (object) - The geographic coordinates of the airport.
    - **latitude** (number) - The latitude.
    - **longitude** (number) - The longitude.
- **meta** (object) - Metadata about the response.
  - **version** (string) - API version.
  - **timestamp** (string) - Timestamp of the response.

### Response Example
{
  "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 Airport by ICAO Code

Source: https://www.iatageo.com/

Retrieve detailed information about an airport using its 4-letter ICAO code.

```APIDOC
## GET /v2/airports/icao/:code

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

### Method
GET

### Endpoint
/v2/airports/icao/:code

### Parameters
#### Path Parameters
- **code** (string) - Required - 4-letter ICAO code (e.g., SBBR, KJFK, KLAX)

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains airport details.
  - **name** (string) - The name of the airport.
  - **iataCode** (string) - The 3-letter IATA code.
  - **icaoCode** (string) - The 4-letter ICAO code.
  - **coordinates** (object) - The geographic coordinates of the airport.
    - **latitude** (number) - The latitude.
    - **longitude** (number) - The longitude.
- **meta** (object) - Metadata about the response.
  - **version** (string) - API version.
  - **timestamp** (string) - Timestamp of the response.

### Response Example
{
  "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"
  }
}
```

--------------------------------

### Find Nearest Airport

Source: https://www.iatageo.com/

Find the closest airport to given geographic coordinates. Supports filtering by airport type and search range.

```APIDOC
## GET /v2/airports/nearest

### Description
Find the nearest airport to given geographic coordinates.

### Method
GET

### Endpoint
/v2/airports/nearest

### Parameters
#### Query Parameters
- **lat** (string) - Required - Latitude (-90 to 90)
- **lng** (string) - Required - Longitude (-180 to 180)
- **types** (string) - Optional - Airport types (comma-separated): large_airport, medium_airport, small_airport
- **range** (string) - Optional - Search range in meters (default: 500000)

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains airport details.
  - **name** (string) - The name of the airport.
  - **iataCode** (string) - The 3-letter IATA code.
  - **icaoCode** (string) - The 4-letter ICAO code.
  - **coordinates** (object) - The geographic coordinates of the airport.
    - **latitude** (number) - The latitude.
    - **longitude** (number) - The longitude.
  - **distanceMeters** (number) - The distance to the airport in meters.
- **meta** (object) - Metadata about the response.
  - **version** (string) - API version.
  - **timestamp** (string) - Timestamp of the response.

### Response Example
{
  "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"
  }
}
```
Tokens:
Raw