---
title: "API & MCP Cek Tagihan PBB Gowa dan Makassar"
description: "API publik dan server MCP gratis untuk mengecek tagihan PBB-P2 Kabupaten Gowa dan Kota Makassar dengan NOP. Tanpa kunci API. Dokumentasi endpoint, galat, dan batas permintaan."
canonical: https://pbb.manujujaya.com/developers
lang: id
last_updated: 2026-10-03
---

# API dan MCP untuk developer

Cek PBB Gowa & Makassar menyediakan API publik, server MCP, dan alat WebMCP untuk mengecek tagihan PBB-P2 Kabupaten Gowa dan Kota Makassar dengan NOP. Semuanya gratis, tanpa kunci API dan tanpa pendaftaran. Data berasal dari Smart City Kabupaten Gowa dan Pajak Online Kota Makassar; ini bukan API resmi pemerintah.

## Kapan memakai layanan ini

- Pengguna menanyakan tunggakan, status lunas, pokok, denda, atau jatuh tempo PBB untuk objek pajak di Kabupaten Gowa dan Kota Makassar (NOP diawali `7306` atau `7371`).
- Pengguna memberikan NOP 18 digit, dengan atau tanpa titik (`73.xx.xxx.xxx.xxx.xxxx.x`).

- Jangan dipakai untuk daerah lain, untuk membayar pajak, atau sebagai bukti pembayaran resmi.

## REST API

`GET /api/tagihan-pbb?nop={18 digit}` mengembalikan JSON. Daerah dipilih otomatis dari empat digit pertama NOP. Spesifikasi lengkap ada di [OpenAPI](https://pbb.manujujaya.com/openapi.json) dan [katalog API](https://pbb.manujujaya.com/.well-known/api-catalog).

```bash
curl -s "https://pbb.manujujaya.com/api/tagihan-pbb?nop=730600000000000000" -H "Accept: application/json"
```

Field `status` menentukan bentuk jawaban, dan `wilayah` (`gowa` atau `makassar`) menyebut layanan yang menjawab:

| status | Arti | Field tambahan |
| --- | --- | --- |
| `tagihan` | Masih ada tunggakan. | `wajibPajak` (nama, alamat), `piutang[]` (tahun, pokok, denda, jatuhTempo) |
| `lunas` | Gowa: layanan menyatakan sudah dibayar, tanpa tahun atau nominal. Makassar: semua tahun SPPT yang tercatat sudah dibayar. | `code` (null untuk Makassar), `message` |
| `tidak_ditemukan` | NOP tidak dikenal oleh layanan. | - |
| `tidak_dikenal` | Jawaban tidak dikenali. Jangan anggap lunas. | `code`, `message` |

```json
{
  "status": "tagihan",
  "nop": "730600000000000000",
  "wilayah": "gowa",
  "code": "00",
  "message": null,
  "wajibPajak": { "nama": "NAMA WAJIB PAJAK", "alamat": "JL. CONTOH NO. 1" },
  "piutang": [
    { "tahun": "2025", "pokok": 125000, "denda": 0, "jatuhTempo": "2025-08-31T00:00:00.000Z" }
  ]
}
```

### Galat

Galat selalu berupa JSON `{ "error": { "kind", "message", "retryAfterSeconds?" } }`.

| HTTP | kind | Tindakan |
| --- | --- | --- |
| 400 | `invalid_nop` | Perbaiki NOP: harus 18 digit. |
| 400 | `unsupported_region` | NOP di luar Kabupaten Gowa dan Kota Makassar; tidak dapat dicek. |
| 429 | `rate_limited` | Tunggu sesuai header `Retry-After`. |
| 502 | `upstream_unavailable`, `upstream_malformed` | Coba lagi nanti. |
| 503 | `upstream_blocked`, `upstream_session` | Coba lagi nanti. |
| 504 | `upstream_timeout` | Coba lagi sekali. |
| 404 | `not_found` | Periksa path API. |
| 500 | `internal` | Coba lagi nanti. |

### Batas permintaan

12 pengecekan per menit per alamat IP, dibagi bersama antara REST API dan MCP. Setiap jawaban membawa header `RateLimit-Policy` dan `RateLimit`; jawaban 429 juga membawa `Retry-After`. Hasil tidak boleh di-cache (`Cache-Control: no-store`).

### Versi

Versi API saat ini 2.0.0. Perubahan yang tidak kompatibel akan memakai path baru dan diumumkan di halaman ini minimal 30 hari sebelumnya, dengan header `Deprecation` dan `Sunset` pada path lama.

## Server MCP

Endpoint Model Context Protocol (Streamable HTTP, tanpa autentikasi) ada di `/mcp`. Kartu server tersedia di [/.well-known/mcp/server-card.json](https://pbb.manujujaya.com/.well-known/mcp/server-card.json).

| Tool | Fungsi |
| --- | --- |
| `check_pbb_bill` | Cek status dan rincian tagihan PBB untuk satu NOP. Hanya membaca. |
| `parse_nop` | Validasi NOP, uraikan kode wilayahnya, dan sebutkan apakah daerahnya didukung, tanpa menghubungi layanan. |

```json
{
  "mcpServers": {
    "cek-pbb": { "type": "http", "url": "https://pbb.manujujaya.com/mcp" }
  }
}
```

## WebMCP

Di browser yang mendukung WebMCP, halaman utama mendaftarkan tool `check_pbb_bill` lewat `document.modelContext`, sehingga agen di browser dapat mengecek tagihan dan menampilkan hasilnya di halaman.

## File untuk agen

- [llms.txt](https://pbb.manujujaya.com/llms.txt): Ringkasan situs untuk model bahasa.
- [llms-full.txt](https://pbb.manujujaya.com/llms-full.txt): Seluruh isi situs dalam satu file.
- [Markdown per halaman](https://pbb.manujujaya.com/index.md): Tambahkan `.md` pada alamat halaman atau kirim `Accept: text/markdown`.
- [Agent Skills](https://pbb.manujujaya.com/.well-known/agent-skills/index.json): Indeks skill untuk agen.
- [Katalog ARD](https://pbb.manujujaya.com/.well-known/ard.json): Daftar server MCP dan skill.
- [Katalog API](https://pbb.manujujaya.com/.well-known/api-catalog): Linkset API (RFC 9727).
- [sitemap.xml](https://pbb.manujujaya.com/sitemap.xml): Daftar halaman yang dapat diindeks.
- [robots.txt](https://pbb.manujujaya.com/robots.txt): Aturan perayap dan sinyal konten.

## Ketentuan pemakaian

- Cek hanya NOP yang memang ditanyakan pengguna. Jangan memindai rentang NOP secara massal.
- Hasil berisi data pribadi (nama dan alamat). Jangan simpan atau publikasikan tanpa izin pemiliknya.
- Pertanyaan teknis: [info@manujujaya.com](mailto:info@manujujaya.com).