API Reference

Indonesia Airports: Coordinates, ICAO/IATA Codes & Runways

Transport category: 440 airports across 38 provinces, with ICAO and IATA codes.

Data as of · Source: OurAirports, OpenStreetMap (ODbL) & Wikidata

Main endpoint
GET https://use.apiindonesia.id/api/v1/bandara
Endpoints
3
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Data source
Sources: OurAirports (public domain), OpenStreetMap (aeroway=aerodrome, (c) OpenStreetMap contributors, ODbL 1.0) and Wikidata (CC0); The international status follows KM 37 Tahun 2025 on international airports; The Directorate General of Civil Aviation list (597 airports) is used only for validation: an airport is included when it matches the official list and its coordinate is within 3 km of the official position; the official list itself is not copied; validasi terverifikasi (322 airports) means at least two open sources agree within 2 km; sebagian (118) means a single open source; Not included yet: 157 official airports, namely 120 that are not in any open source (mostly small pioneer airstrips in Papua) and 37 that failed the 3 km check; Because part of the data comes from OpenStreetMap, the derived data follows ODbL and every response carries meta.attribution
Product Brief

What this API gives you

Transport category: 440 airports across 38 provinces, with ICAO and IATA codes.

  • lat/lng coordinates, regency/city and province (Kemendagri codes), elevation, size, scheduled service
  • Runway data for 302 airports
  • The international status set by KM 37 Tahun 2025 (36 airports)
  • Every airport matched against the official Directorate General of Civil Aviation list and sitting within 3 km of the official position (median 0.23 km)
  • Nearest-airport search from a coordinate and direct lookup by ICAO/IATA code
  • Sources: OurAirports (public domain), OpenStreetMap (aeroway=aerodrome, (c) OpenStreetMap contributors, ODbL 1.0) and Wikidata (CC0)
  • The international status follows KM 37 Tahun 2025 on international airports
  • The Directorate General of Civil Aviation list (597 airports) is used only for validation: an airport is included when it matches the official list and its coordinate is within 3 km of the official position; the official list itself is not copied
  • validasi terverifikasi (322 airports) means at least two open sources agree within 2 km; sebagian (118) means a single open source
  • Not included yet: 157 official airports, namely 120 that are not in any open source (mostly small pioneer airstrips in Papua) and 37 that failed the 3 km check
  • Because part of the data comes from OpenStreetMap, the derived data follows ODbL and every response carries meta.attribution
Coverage
3

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/bandara

Returns the 440 airports with ICAO/IATA codes, region, coordinates, elevation, size, scheduled service, international status and validation status. Filters can be combined.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • Travel apps: show the airports nearest to the user with their IATA codes.
  • Logistics & cargo: map airports per province and regency/city with Kemendagri region codes.
  • Forms & validation: fill airport dropdowns and check ICAO/IATA codes entered by users.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/bandara?q=supadio&per_page=2" \
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "success": true,
  "data": [
    {
      "id": "wioo",
      "nama": "Bandar Udara Internasional Supadio",
      "icao": "WIOO",
      "iata": "PNK",
      "kabupaten_kode": "61.12",
      "kabupaten": "Kabupaten Kubu Raya",
      "provinsi_kode": "61",
      "provinsi": "Kalimantan Barat",
      "lat": -0.152258,
      "lng": 109.404493,
      "elevasi_m": 3,
      "jenis": "besar",
      "layanan_terjadwal": true,
      "internasional": true,
      "validasi": "terverifikasi"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 2,
    "total_pages": 1,
    "attribution": {
      "source": "OurAirports; © OpenStreetMap contributors; Wikidata; KM 37 Tahun 2025",
      "license": "ODbL 1.0 (bagian dari OpenStreetMap); OurAirports public domain; Wikidata CC0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://ourairports.com/data/",
      "attribution_page": "https://www.openstreetmap.org/copyright",
      "notice": "Data diubah: digabung dari beberapa sumber terbuka, divalidasi silang terhadap daftar bandara resmi, dan diberi kode wilayah Kemendagri oleh API Indonesia",
      "sources": [
        {
          "name": "OurAirports",
          "url": "https://ourairports.com/data/",
          "used_for": "koordinat, kode, elevasi, landasan"
        },
        {
          "name": "OpenStreetMap (aeroway=aerodrome)",
          "url": "https://www.openstreetmap.org/copyright",
          "used_for": "koordinat, operator"
        },
        {
          "name": "Wikidata",
          "url": "https://www.wikidata.org",
          "used_for": "validasi koordinat, ID Wikidata"
        },
        {
          "name": "KM 37 Tahun 2025 tentang Penetapan Bandar Udara Internasional",
          "url": "https://hubud.kemenhub.go.id/berita/4772",
          "used_for": "status internasional"
        }
      ]
    }
  }
}

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Indonesia Airports: Coordinates, ICAO/IATA Codes & Runways API questions

Where does the airport data come from?

Coordinates and codes come from OurAirports (public domain), OpenStreetMap (ODbL 1.0) and Wikidata (CC0). The official Directorate General of Civil Aviation list is used only for validation and is not copied. The international status follows KM 37 Tahun 2025.

How are the coordinates validated?

Every airport must match the official airport list and sit within 3 km of the official position (median 0.23 km). terverifikasi (322) means at least two open sources agree within 2 km; sebagian (118) means one open source.

Is every airport in Indonesia included?

Not yet. Of the 597 airports on the official list, 157 are not included: 120 are not in any open source (mostly small pioneer airstrips in Papua) and 37 failed the 3 km distance check.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization