API Reference

Indonesia Ports: Sea and Ferry Ports (National Port Master Plan)

Transport category: 1,082 ports from the National Port Master Plan (RIPN).

Data as of · Source: RIPN KP 432/2017, OpenStreetMap (ODbL) & World Port Index

Main endpoint
GET https://use.apiindonesia.id/api/v1/pelabuhan
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
List, hierarchy and ferry-class source: KP 432 Tahun 2017 on the National Port Master Plan as amended by KM 30 Tahun 2020 (regulations are not copyrighted); Hierarchy uses the 2022 period column; the 2017, 2027 and 2037 values are included too; Not applied yet: the KM 172 Tahun 2021 amendment and most of KM 217 Tahun 2022; Coordinate sources: OpenStreetMap ((c) OpenStreetMap contributors, ODbL 1.0), the NGA World Port Index (public domain), UN/LOCODE (UNECE) and Wikidata (CC0), only when they pass validation; terverifikasi (178) means at least two independent sources agree within 5 km and the province matches RIPN; sebagian (290) means one source with matching province and regency/city; Other ports are listed without coordinates (lat/lng null, validasi tanpa_koordinat) rather than with an estimate; Every response carries meta.attribution
Product Brief

What this API gives you

Transport category: 1,082 ports from the National Port Master Plan (RIPN).

  • 637 sea ports with their official hierarchy (28 utama, 164 pengumpul, 165 pengumpan regional, 279 pengumpan lokal)
  • 445 ferry ports with class I/II/III
  • Every port has its province and regency/city (Kemendagri codes)
  • 468 ports have validated coordinates, 133 have a UN/LOCODE and 84 have World Port Index details
  • Nearest-port search from a coordinate
  • List, hierarchy and ferry-class source: KP 432 Tahun 2017 on the National Port Master Plan as amended by KM 30 Tahun 2020 (regulations are not copyrighted)
  • Hierarchy uses the 2022 period column; the 2017, 2027 and 2037 values are included too
  • Not applied yet: the KM 172 Tahun 2021 amendment and most of KM 217 Tahun 2022
  • Coordinate sources: OpenStreetMap ((c) OpenStreetMap contributors, ODbL 1.0), the NGA World Port Index (public domain), UN/LOCODE (UNECE) and Wikidata (CC0), only when they pass validation
  • terverifikasi (178) means at least two independent sources agree within 5 km and the province matches RIPN; sebagian (290) means one source with matching province and regency/city
  • Other ports are listed without coordinates (lat/lng null, validasi tanpa_koordinat) rather than with an estimate
  • 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/pelabuhan

Returns the 1,082 sea and ferry ports with hierarchy or class, region, UN/LOCODE, coordinates when validated 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.

  • Sea logistics: find the nearest ports and their hierarchy for shipping and freight route planning.
  • Ferry & tourism apps: list ferry ports per regency/city.
  • Research & policy: analyse how main, collector and feeder ports are spread across provinces.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/pelabuhan?hierarki=utama&provinsi=31&per_page=2" \
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "success": true,
  "data": [
    {
      "id": "tg-priok-jakarta-utara",
      "nama": "Tg. Priok",
      "jenis": "laut",
      "hierarki": "utama",
      "kelas": null,
      "status_operasi": null,
      "provinsi": "Daerah Khusus Ibukota Jakarta",
      "provinsi_kode": "31",
      "kabupaten": "Kota Administrasi Jakarta Utara",
      "kabupaten_kode": "31.72",
      "unlocode": "IDJKT",
      "lat": -6.104507,
      "lng": 106.882862,
      "validasi": "terverifikasi"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 2,
    "total_pages": 1,
    "attribution": {
      "source": "Rencana Induk Pelabuhan Nasional (KP 432 Tahun 2017); © OpenStreetMap contributors; NGA World Port Index; UN/LOCODE; Wikidata",
      "license": "ODbL 1.0 (koordinat dari OpenStreetMap); WPI public domain; Wikidata CC0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://msi.nga.mil/Publications/WPI",
      "attribution_page": "https://www.openstreetmap.org/copyright",
      "notice": "Data diubah: daftar RIPN dicocokkan dengan sumber koordinat terbuka; koordinat hanya diisi bila lolos validasi, oleh API Indonesia",
      "sources": [
        {
          "name": "KP 432 Tahun 2017 tentang Rencana Induk Pelabuhan Nasional (dan perubahannya)",
          "url": "https://jdih.kemenhub.go.id",
          "used_for": "daftar pelabuhan, hierarki, kelas penyeberangan"
        },
        {
          "name": "OpenStreetMap",
          "url": "https://www.openstreetmap.org/copyright",
          "used_for": "koordinat"
        },
        {
          "name": "NGA World Port Index (Pub. 150)",
          "url": "https://msi.nga.mil/Publications/WPI",
          "used_for": "koordinat, atribut pelabuhan"
        },
        {
          "name": "UN/LOCODE (UNECE)",
          "url": "https://unece.org/trade/cefact/unlocode-code-list-country-and-territory",
          "used_for": "kode UN/LOCODE, koordinat"
        },
        {
          "name": "Wikidata",
          "url": "https://www.wikidata.org",
          "used_for": "validasi koordinat"
        }
      ]
    }
  }
}

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 Ports: Sea and Ferry Ports (National Port Master Plan) API questions

Where does the port list come from?

From the National Port Master Plan: KP 432 Tahun 2017 as amended by KM 30 Tahun 2020. Amendments KM 172 Tahun 2021 and most of KM 217 Tahun 2022 are not applied yet.

Why do some ports have no coordinates?

Coordinates are filled only when they pass validation (468 ports). Other ports are still listed with lat/lng null and validasi tanpa_koordinat instead of an estimate.

What do terverifikasi and sebagian mean?

terverifikasi (178) means at least two independent sources (OpenStreetMap, World Port Index, UN/LOCODE) agree within 5 km and the province matches RIPN. sebagian (290) means one source with matching province and regency/city.

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