Peta Kuesus API

Dataset metadata, source references, region counts, and boundary coverage notes.

{
  "name": "Peta Kuesus API",
  "counts": { "province": 38, "regency": 514, "district": 7285, "village": 83762 },
  "boundaries": { "included": true, "required": false }
}

All Indonesian provinces.

[
  { "code": "33", "name": "Jawa Tengah", "boundary": { "available": true } }
]

Regencies and cities under one province code.

[
  { "code": "33.75", "province_code": "33", "name": "Kota Pekalongan", "boundary": { "available": true } }
]

Districts under one regency or city. Path parameters use compact codes without dots.

[
  { "code": "33.75.03", "regency_code": "33.75", "province_code": "33", "name": "Pekalongan Barat" }
]

Villages under one district. Path parameters use compact codes without dots.

[
  { "code": "33.75.03.1001", "district_code": "33.75.03", "name": "Medono", "postal_code": "51111" }
]

Advanced/offline region data helper grouped by province. Most clients should use /search instead.

[
  { "code": "33.75.03.1001", "name": "Medono", "search": "3375031001 medono", "province_code": "33" }
]

Compact Indonesian region autocomplete for forms, checkout pages, CRM apps, and postal-code autofill.

{
  "data": [
    {
      "label": "Banyumudal, Moga, Pemalang, Jawa Tengah",
      "level": "village",
      "code": "33.27.07.2006",
      "name": "Banyumudal",
      "postal_code": "52354",
      "components": {
        "province": { "code": "33", "name": "Jawa Tengah" },
        "regency": { "code": "33.27", "name": "Kabupaten Pemalang" },
        "district": { "code": "33.27.07", "name": "Moga" },
        "village": { "code": "33.27.07.2006", "name": "Banyumudal" }
      },
      "boundary": { "available": true }
    }
  ],
  "meta": { "query": "banyumudal", "limit": 10, "count": 1 }
}

Search regions by name, code, compact code, and postal-code signals.

{
  "data": [
    {
      "level": "village",
      "code": "21.03.19.2002",
      "name": "Air Nusa",
      "parent_path": "Kepulauan Riau / Natuna / Serasan Timur",
      "postal_code": "29780",
      "boundary": { "available": true }
    }
  ],
  "meta": { "query": "air nusa", "limit": 20, "count": 1 }
}

Return one normalized region by dotted or compact code.

{
  "data": {
    "level": "village",
    "code": "21.03.19.2002",
    "code_plain": "2103192002",
    "name": "Air Nusa",
    "parent_path": "Kepulauan Riau / Natuna / Serasan Timur",
    "province_code": "21",
    "regency_code": "21.03",
    "district_code": "21.03.19",
    "postal_code": "29780",
    "boundary": { "available": true },
    "bbox": [109.0, 2.0, 109.2, 2.2]
  }
}

List direct child regions below a province, regency, or district.

{
  "data": [
    { "level": "district", "code": "21.03.19", "name": "Serasan Timur", "parent_path": "Kepulauan Riau / Natuna" }
  ],
  "meta": { "limit": 100, "offset": 0, "count": 1 }
}

Return the ancestor chain for a region.

{
  "data": [
    { "level": "province", "code": "21", "name": "Kepulauan Riau" },
    { "level": "regency", "code": "21.03", "name": "Natuna" },
    { "level": "district", "code": "21.03.19", "name": "Serasan Timur" }
  ]
}

Return a GeoJSON Feature for one selected region when boundary data is available.

GeoJSON Feature response.
Coordinates are omitted from this example to avoid sample or placeholder geometry.

Return a GeoJSON FeatureCollection for selected regions. Parent regions export exactly by default.

{
  "codes": ["21.03.19.2002", "33.27"],
  "scope": "selected",
  "simplify": false
}

Explicitly expand parent regions to regency/city, district, or village boundaries. Village expansion can be large.

{
  "codes": ["33.27"],
  "scope": "districts",
  "simplify": false
}

Find regions whose available boundaries contain a latitude/longitude point.

{
  "data": {
    "point": { "lat": 2.0, "lng": 109.1 },
    "matches": [
      { "level": "village", "code": "21.03.19.2002", "name": "Air Nusa" }
    ]
  }
}

Check whether a specific region boundary contains a latitude/longitude point.

{
  "data": {
    "contains": true,
    "region": { "level": "village", "code": "21.03.19.2002", "name": "Air Nusa" }
  }
}

Data wilayah dari cahyadsn/wilayah, kode pos dari cahyadsn/wilayah_kodepos, dan boundary tersedia dari cahyadsn/wilayah_boundaries jika cakupan datanya ada.

Autocomplete Indonesian provinces, regencies, districts, villages, and postal codes from a plain HTML form. The widget calls /autocomplete and emits peta-kuesus:select when a user selects a region.

<script src="https://peta.kues.us/embed/region-picker.js"></script>

<div
  data-peta-kuesus-picker
  data-placeholder="Cari wilayah..."
  data-postal-code="true"
></div>

document.addEventListener('peta-kuesus:select', (event) => {
  console.log(event.detail);
});

For local HTML testing, prefer a local static server instead of opening the file with file://.

python3 -m http.server 8080

/autocomplete is public by design for embedded forms: it uses no credentials, returns public region data only, and remains rate-limited. Other API endpoints keep stricter cross-origin rules.

const apiUrl = 'https://api.peta.kues.us';
const params = new URLSearchParams({ q: 'moga pemalang', limit: '10' });

const suggestions = await fetch(`${apiUrl}/autocomplete?${params}`).then((res) => res.json());

const baseUrl = 'https://peta.kues.us/api/v1';

const provinces = await fetch(`${baseUrl}/provinces.json`).then((res) => res.json());
const regencies = await fetch(`${baseUrl}/regencies/by-province/33.json`).then((res) =>
  res.json()
);

const apiUrl = 'https://api.peta.kues.us';
const params = new URLSearchParams({ q: 'air nusa', limit: '5' });

const results = await fetch(`${apiUrl}/search?${params}`).then((res) => res.json());

const apiUrl = 'https://api.peta.kues.us';

const region = await fetch(`${apiUrl}/regions/21.03.19.2002`).then((res) => res.json());
const ancestors = await fetch(`${apiUrl}/regions/21.03.19.2002/ancestors`).then((res) =>
  res.json()
);

const apiUrl = 'https://api.peta.kues.us';

const collection = await fetch(`${apiUrl}/boundaries`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    codes: ['21.03.19.2002', '33.27'],
    scope: 'selected',
    simplify: false
  })
}).then((res) => res.json());