Mulai Cepat

Kode Pos API menyediakan data kode pos Indonesia melalui MCP Server, REST API, dan GraphQL API. Dokumentasi ini akan membantu Anda mulai menggunakan API dalam beberapa menit.

Prasyarat

Autentikasi

Semua request memerlukan header Authorization: Bearer untuk autentikasi.

curl -H "Authorization: Bearer kp_live_xxxxxxxxxxxxxxxx" \
  https://api.kodepos.dev/kodepos/api/provinces

MCP Server

Cara tercepat untuk menggunakan Kode Pos API adalah melalui MCP (Model Context Protocol) Server. Tambahkan konfigurasi berikut ke MCP client Anda (Claude Desktop, Cursor, VS Code) dan AI agent akan langsung bisa mengakses data kode pos — tanpa menulis kode HTTP.

{
  "mcpServers": {
    "kodepos": {
      "url": "https://api.kodepos.dev/api/kodepos/mcp",
      "headers": {
        "Authorization": "Bearer kp_live_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

REST API

Jika Anda membangun aplikasi secara langsung, gunakan REST API atau GraphQL API. Cari kelurahan/desa berdasarkan kata kunci menggunakan endpoint /search:

curl -H "Authorization: Bearer kp_live_xxxxxxxxxxxxxxxx" \
  "https://api.kodepos.dev/kodepos/api/search?q=menteng&first=5"

Contoh Response

Response menggunakan format envelope success + data, dengan data berisi array kelurahan/desa beserta hierarki lengkap.

{
  "success": true,
  "data": [
    {
      "code": "31.73.06.1003",
      "name": "Menteng",
      "postalCode": "10310",
      "district": {
        "code": "31.73.06",
        "name": "Menteng"
      },
      "city": {
        "code": "31.73",
        "name": "Kota Jakarta Pusat"
      },
      "province": {
        "code": "31",
        "name": "DKI Jakarta"
      }
    }
  ],
  "pagination": {
    "hasNextPage": true,
    "endCursor": "eyJjb2RlIjoiMzEuNzMuMDYuMTAwMyJ9"
  }
}

Langkah Selanjutnya