# Indonesia — Zapi reference

> Every Indonesia endpoint on Zapi, with parameters, request shape and an example response.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a key at https://zpi.web.id/dashboard/keys (free tier — 2,000 req/mo, no credit card).
**Response envelope:** `{ status: "success" | "error", message: string, content: <payload> }`
**Rate limit:** 60 req/min (free tier). Per-endpoint cache TTL is documented below.
**Errors:** standard HTTP codes (`401` invalid key, `429` rate limited, `5xx` upstream). Body always has `{ status: "error", message, errors? }`.

```bash
curl "https://api.zpi.web.id/v1/CATEGORY:SCRAPER/ENDPOINT?param=value" \
  -H "x-api-key: $ZAPI_KEY"
```

**Category page:** https://zpi.web.id/category/indonesia
**Full catalog:** https://zpi.web.id/apis · **Index:** https://zpi.web.id/llms-full.txt

---

## Cek BPOM

**Category:** indonesia · **Slug:** `cek-bpom`
**Detail page:** https://zpi.web.id/api/indonesia/cek-bpom

Pencarian registrasi produk obat, kosmetik, suplemen, dan pangan pada database resmi BPOM RI.

**Tags:** bpom, produk, registrasi, obat, kosmetik, indonesia

### Lookup Produk BPOM

Cari produk terdaftar BPOM berdasarkan nama atau nomor registrasi.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:cek-bpom/lookup`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Nama produk atau nomor registrasi BPOM yang akan dicari (min 2 char). |
| `type` | enum(nama_produk|nomor_registrasi) | query | no | Jenis pencarian: 'nama_produk' atau 'nomor_registrasi'. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:cek-bpom/lookup?query=PARACETAMOL&type=nama_produk" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:cek-bpom/lookup?query=PARACETAMOL&type=nama_produk", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:cek-bpom/lookup?query=PARACETAMOL&type=nama_produk",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ok": true,
  "type": "nama_produk",
  "count": 20,
  "query": "PARACETAMOL",
  "results": [
    {
      "form": "SIRUP",
      "brand": null,
      "status": "Berlaku",
      "registrar": "RAMA EMERALD MULTI SUKSES - Indonesia",
      "submitDate": "2026-05-27",
      "expiredDate": "2031-05-24",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "RAMA EMERALD MULTI SUKSES - Indonesia",
      "packagingInfo": "BOTOL @ 60 ML",
      "productCategory": "Obat",
      "registrationDate": "2026-05-24",
      "registrationNumber": "GBL2628921437A1",
      "manufacturerAddress": "DESA TENARU",
      "manufacturerLocation": "KAB. GRESIK"
    },
    {
      "form": "KAPLET",
      "brand": null,
      "status": "Berlaku",
      "registrar": "AFIFARMA - Indonesia",
      "submitDate": "2026-05-27",
      "expiredDate": "2031-05-24",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "AFIFARMA - Indonesia",
      "packagingInfo": "DUS, 10 AMPLOP @ 1 STRIP @ 10 KAPLET",
      "productCategory": "Obat",
      "registrationDate": "2026-05-24",
      "registrationNumber": "GBL2201712204A2",
      "manufacturerAddress": "JL. MAUNI INDUSTRI NO.8",
      "manufacturerLocation": "KOTA KEDIRI"
    },
    {
      "form": "SUPPOSITORIA",
      "brand": null,
      "status": "Berlaku",
      "registrar": "INTERBAT - Indonesia",
      "submitDate": "2026-05-27",
      "expiredDate": "2031-05-20",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "INTERBAT - Indonesia",
      "packagingInfo": "DUS, 2 BLISTER @ 6 SUPPOSITORIA",
      "productCategory": "Obat",
      "registrationDate": "2026-05-20",
      "registrationNumber": "GKL2617636853B1",
      "manufacturerAddress": "JL. H.R. MOCH. MANGUNDIPROJO NO.1 BUDURAN",
      "manufacturerLocation": "KAB. SIDOARJO"
    },
    {
      "form": "SUPPOSITORIA",
      "brand": null,
      "status": "Berlaku",
      "registrar": "INTERBAT - Indonesia",
      "submitDate": "2026-05-27",
      "expiredDate": "2031-05-19",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "INTERBAT - Indonesia",
      "packagingInfo": "DUS, 2 BLISTER @ 6 SUPPOSITORIA",
      "productCategory": "Obat",
      "registrationDate": "2026-05-19",
      "registrationNumber": "GKL2617636853A1",
      "manufacturerAddress": "JL. H.R. MOCH. MANGUNDIPROJO NO.1 BUDURAN",
      "manufacturerLocation": "KAB. SIDOARJO"
    },
    {
      "form": "SIRUP",
      "brand": null,
      "status": "Berlaku",
      "registrar": "PIM PHARMACEUTICALS - Indonesia",
      "submitDate": "2026-05-27",
      "expiredDate": "2031-05-04",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "PIM PHARMACEUTICALS - Indonesia",
      "packagingInfo": "BOTOL PLASTIK @ 60 ML",
      "productCategory": "Obat",
      "registrationDate": "2026-05-13",
      "registrationNumber": "GBL0918906537A1",
      "manufacturerAddress": "JL. RAYA CANDIWATES NO. 20",
      "manufacturerLocation": "KAB. PASURUAN"
    },
    {
      "form": "SIRUP",
      "brand": null,
      "status": "Berlaku",
      "registrar": "PIM PHARMACEUTICALS - Indonesia",
      "submitDate": "2026-05-27",
      "expiredDate": "2031-05-04",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "PIM PHARMACEUTICALS - Indonesia",
      "packagingInfo": "DUS, 1 BOTOL PLASTIK @ 60 ML",
      "productCategory": "Obat",
      "registrationDate": "2026-05-13",
      "registrationNumber": "GBL0918906537A1",
      "manufacturerAddress": "JL. RAYA CANDIWATES NO. 20",
      "manufacturerLocation": "KAB. PASURUAN"
    },
    {
      "form": "SIRUP",
      "brand": null,
      "status": "Berlaku",
      "registrar": "IMFARMIND FARMASI INDUSTRI - Indonesia",
      "submitDate": "2026-05-25",
      "expiredDate": "2031-05-11",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "IMFARMIND FARMASI INDUSTRI - Indonesia",
      "packagingInfo": "BOTOL PLASTIK @ 60 ML",
      "productCategory": "Obat",
      "registrationDate": "2026-05-11",
      "registrationNumber": "GBL1409608637A1",
      "manufacturerAddress": "DESA WONOKOYO",
      "manufacturerLocation": "KAB. PASURUAN"
    },
    {
      "form": "KAPLET",
      "brand": null,
      "status": "Berlaku",
      "registrar": "PERUSAHAAN INDUSTRI FARMASI DAN DAGANG FIRST MEDIPHARMA - Indonesia",
      "submitDate": "2026-05-25",
      "expiredDate": "2031-04-25",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "PERUSAHAAN INDUSTRI FARMASI DAN DAGANG FIRST MEDIPHARMA - Indonesia",
      "packagingInfo": "DUS, 10 AMPLOP @ 1 STRIP @ 10 KAPLET",
      "productCategory": "Obat",
      "registrationDate": "2026-05-11",
      "registrationNumber": "GBL9607102904A1",
      "manufacturerAddress": "JL. RAYA SUMORAME NO. 41",
      "manufacturerLocation": "KAB. SIDOARJO"
    },
    {
      "form": "DROPS",
      "brand": null,
      "status": "Berlaku",
      "registrar": "DEXA MEDICA - Indonesia",
      "submitDate": "2026-05-11",
      "expiredDate": "2031-04-24",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "DEXA MEDICA - Indonesia",
      "packagingInfo": "DUS, 1 BOTOL @ 15 ML",
      "productCategory": "Obat",
      "registrationDate": "2026-04-24",
      "registrationNumber": "GBL2605069636B1",
      "manufacturerAddress": "Jl. Jend. Bambang Utoyo No. 138",
      "manufacturerLocation": "KOTA PALEMBANG"
    },
    {
      "form": "KAPLET",
      "brand": null,
      "status": "Berlaku",
      "registrar": "PABRIK PHARMASI DAN KIMIA DASA ESA FARMA - Indonesia",
      "submitDate": "2026-05-05",
      "expiredDate": "2031-04-17",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "PABRIK PHARMASI DAN KIMIA DASA ESA FARMA - Indonesia",
      "packagingInfo": "BOTOL PLASTIK @ 100 KAPLET",
      "productCategory": "Obat",
      "registrationDate": "2026-04-17",
      "registrationNumber": "GBL7204602304A1",
      "manufacturerAddress": "JL. RAYA KEDAMEAN NO. 78",
      "manufacturerLocation": "KAB. GRESIK"
    },
    {
      "form": "KAPLET",
      "brand": null,
      "status": "Berlaku",
      "registrar": "MEGA ESA FARMA - Indonesia",
      "submitDate": "2026-04-08",
      "expiredDate": "2030-11-17",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "MEGA ESA FARMA - Indonesia",
      "packagingInfo": "DUS, 10 AMPLOP @ 1 STRIP @ 10 KAPLET",
      "productCategory": "Obat",
      "registrationDate": "2026-03-18",
      "registrationNumber": "GBL8715201504A2",
      "manufacturerAddress": "JL. KAPUK RAYA KAMAL NO 66",
      "manufacturerLocation": "KODYA JAKARTA UTARA"
    },
    {
      "form": "DROPS",
      "brand": null,
      "status": "Berlaku",
      "registrar": "BERNOFARM - Indonesia",
      "submitDate": "2026-03-31",
      "expiredDate": "2031-03-14",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "BERNOFARM - Indonesia",
      "packagingInfo": "DUS, 1 BOTOL @ 10 ML",
      "productCategory": "Obat",
      "registrationDate": "2026-03-14",
      "registrationNumber": "GBL2602369136A1",
      "manufacturerAddress": "Jl. Gatot Subroto No. 68, Banjarkemantren Km. 18",
      "manufacturerLocation": "KAB. SIDOARJO"
    },
    {
      "form": "SUSPENSI",
      "brand": null,
      "status": "Berlaku",
      "registrar": "DEXA MEDICA - Indonesia",
      "submitDate": "2026-03-29",
      "expiredDate": "2031-01-27",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "DEXA MEDICA - Indonesia",
      "packagingInfo": "DUS, 1 BOTOL PLASTIK @ 60 ML",
      "productCategory": "Obat",
      "registrationDate": "2026-01-27",
      "registrationNumber": "GBL2605069633A1",
      "manufacturerAddress": "Jl. Jend. Bambang Utoyo No. 138",
      "manufacturerLocation": "KOTA PALEMBANG"
    },
    {
      "form": "INFUS",
      "brand": null,
      "status": "Berlaku",
      "registrar": "IPHA LABORATORIES - Indonesia",
      "submitDate": "2026-03-30",
      "expiredDate": "2031-01-16",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "IPHA LABORATORIES - Indonesia",
      "packagingInfo": "DUS, 1 VIAL @ 100 ML",
      "productCategory": "Obat",
      "registrationDate": "2026-01-16",
      "registrationNumber": "GKL2110403249A1",
      "manufacturerAddress": "Jl. Ds Cibingbin Ciampel (Jl. Terusan BPG) RT007 / RW003, desa Laksanamekar ,  Kecamatan Padalarang, Kabupaten Bandung Barat.",
      "manufacturerLocation": "KAB. BANDUNG BARAT"
    },
    {
      "form": "SIRUP",
      "brand": null,
      "status": "Berlaku",
      "registrar": "EMDI MELIA PHARMA - Indonesia",
      "submitDate": "2026-03-10",
      "expiredDate": "2030-12-31",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "EMDI MELIA PHARMA - Indonesia",
      "packagingInfo": "DUS, 1 BOTOL PLASTIK @ 60 ML",
      "productCategory": "Obat",
      "registrationDate": "2025-12-31",
      "registrationNumber": "GBL2558402637A1",
      "manufacturerAddress": "JL SIMPANG PARAKAN MUNCANG KM 5 NO 14 RT 22 RW 05 KELURAHAN MEKARBAKTI",
      "manufacturerLocation": "KAB. SUMEDANG"
    },
    {
      "form": "TABLET",
      "brand": null,
      "status": "Berlaku",
      "registrar": "PYRIDAM FARMA TBK - Indonesia",
      "submitDate": "2026-01-01",
      "expiredDate": "2030-12-31",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "PYRIDAM FARMA TBK - Indonesia",
      "packagingInfo": "DUS, 10 AMPLOP @ 1 STRIP @ 10 TABLET",
      "productCategory": "Obat",
      "registrationDate": "2025-12-31",
      "registrationNumber": "GBL1921024910A1",
      "manufacturerAddress": "Jl. Hanjawar Pacet RT 01 RW 02, Cibodas.",
      "manufacturerLocation": "KAB. CIANJUR"
    },
    {
      "form": "KAPLET",
      "brand": null,
      "status": "Berlaku",
      "registrar": "PYRIDAM FARMA TBK - Indonesia",
      "submitDate": "2026-01-01",
      "expiredDate": "2030-12-31",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "PYRIDAM FARMA TBK - Indonesia",
      "packagingInfo": "DUS, 10 AMPLOP @ 1 STRIP @ 10 KAPLET",
      "productCategory": "Obat",
      "registrationDate": "2025-12-31",
      "registrationNumber": "GBL2521024904A1",
      "manufacturerAddress": "Jl. Hanjawar Pacet RT 01 RW 02, Cibodas.",
      "manufacturerLocation": "KAB. CIANJUR"
    },
    {
      "form": "TABLET",
      "brand": null,
      "status": "Berlaku",
      "registrar": "MERSIFARMA TIRMAKU MERCUSANA - Indonesia",
      "submitDate": "2025-12-27",
      "expiredDate": "2030-06-23",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "MERSIFARMA TIRMAKU MERCUSANA - Indonesia",
      "packagingInfo": "DUS, 10 AMPLOP @ 1 BLISTER @ 10 TABLET",
      "productCategory": "Obat",
      "registrationDate": "2025-12-26",
      "registrationNumber": "GBL1533312610A1",
      "manufacturerAddress": "JL RAYA PELABUHAN KM 18 DESA CIKEMBAR, KECAMATAN CIKEMBAR, KABUPATEN SUKABUMI, JAWA BARAT",
      "manufacturerLocation": "KAB. SUKABUMI"
    },
    {
      "form": "TABLET",
      "brand": null,
      "status": "Berlaku",
      "registrar": "MEPROFARM - Indonesia",
      "submitDate": "2025-12-22",
      "expiredDate": "2030-02-21",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "MEPROFARM - Indonesia",
      "packagingInfo": "DUS, 20 AMPLOP @ 1 BLISTER @ 10 TABLET",
      "productCategory": "Obat",
      "registrationDate": "2025-12-21",
      "registrationNumber": "GBL2215634610A1",
      "manufacturerAddress": "JL. SOEKARNO HATTA NO. 789",
      "manufacturerLocation": "KOTA BANDUNG"
    },
    {
      "form": "ENEMA",
      "brand": null,
      "status": "Berlaku",
      "registrar": "NOVELL PHARMACEUTICAL LABORATORIES - Indonesia",
      "submitDate": "2025-12-17",
      "expiredDate": "2030-12-17",
      "ingredients": "PARACETAMOL",
      "productName": "PARACETAMOL",
      "manufacturer": "NOVELL PHARMACEUTICAL LABORATORIES - Indonesia",
      "packagingInfo": "DUS, 5 ALUBAG @ 1 RECTAL TUBE @ 2,5 ML",
      "productCategory": "Obat",
      "registrationDate": "2025-12-17",
      "registrationNumber": "GBL1933546558A1",
      "manufacturerAddress": "Jl Wanaherang No 35 Tlajung Udik",
      "manufacturerLocation": "KAB. BOGOR"
    }
  ],
  "totalMatched": 167
}
```

---

## Cek Halal

**Category:** indonesia · **Slug:** `cek-halal`
**Detail page:** https://zpi.web.id/api/indonesia/cek-halal

Pencarian sertifikat halal produk dari database resmi BPJPH (Badan Penyelenggara Jaminan Produk Halal).

**Tags:** halal, sertifikat, bpjph, produk, indonesia

### Lookup Sertifikat Halal

Cari produk bersertifikat halal berdasarkan nama produk.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:cek-halal/lookup`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Nama produk halal yang akan dicari (min 2 karakter). |
| `type` | enum(produk|perusahaan) | query | no | Mode pencarian: 'produk' (default, cari nama produk) atau 'perusahaan' (filter tambahan nama pelaku usaha). |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:cek-halal/lookup?query=INDOMIE&type=produk" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:cek-halal/lookup?query=INDOMIE&type=produk", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:cek-halal/lookup?query=INDOMIE&type=produk",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ok": true,
  "type": "produk",
  "count": 10,
  "query": "INDOMIE",
  "results": [
    {
      "id": "003a8dfb-d7d7-46d5-9641-9b3c05f3db51",
      "brand": null,
      "status": "Halal",
      "company": "Warung Zam Zam Resto & Kopi Halim Raya",
      "issueDate": "23 May 2026",
      "certNumber": "ID31110073291550526",
      "validUntil": null,
      "productName": "Indomie Ayam Geprek/Internet/Telor - Warung Zam Zam Resto & Kopi Halim Raya",
      "productType": null
    },
    {
      "id": "c0da778f-b23b-47d0-9ef4-75717cc423fd",
      "brand": null,
      "status": "Halal",
      "company": "JAMIYO/KEDAI BAKSO TIMBUL",
      "issueDate": "23 May 2026",
      "certNumber": "ID32110073256340526",
      "validUntil": null,
      "productName": "Bakso Urat Indomie",
      "productType": null
    },
    {
      "id": "c45d72a7-6e83-478d-a609-3fa898c8073a",
      "brand": null,
      "status": "Halal",
      "company": "JAMIYO/KEDAI BAKSO TIMBUL",
      "issueDate": "23 May 2026",
      "certNumber": "ID32110073256340526",
      "validUntil": null,
      "productName": "Bakso Telur Indomie",
      "productType": null
    },
    {
      "id": "31f0ad63-c82e-422a-8bb0-8cedf6f7b40d",
      "brand": null,
      "status": "Halal",
      "company": "CV. SUMO",
      "issueDate": "22 May 2026",
      "certNumber": "ID12110073008970526",
      "validUntil": null,
      "productName": "Indomie Bumbu Aceh",
      "productType": null
    },
    {
      "id": "0d126b3b-bc8f-4c04-8b23-a1943f0c3b79",
      "brand": null,
      "status": "Halal",
      "company": "SUSANTI",
      "issueDate": "21 May 2026",
      "certNumber": "ID21110072832410526",
      "validUntil": null,
      "productName": "Indomie Goreng 'Mak Uteh'",
      "productType": null
    },
    {
      "id": "a93a4e4c-932c-4c61-8f37-8f24a179db5e",
      "brand": null,
      "status": "Halal",
      "company": "SUSANTI",
      "issueDate": "21 May 2026",
      "certNumber": "ID21110072832410526",
      "validUntil": null,
      "productName": "Indomie Rebus 'Mak Uteh'",
      "productType": null
    },
    {
      "id": "fa50f111-e2cb-45cd-818a-e99642546ddc",
      "brand": null,
      "status": "Halal",
      "company": "HOSU Coffee and Eatery",
      "issueDate": "21 May 2026",
      "certNumber": "ID32110072925550526",
      "validUntil": null,
      "productName": "Indomie Goreng dan Rebus",
      "productType": null
    },
    {
      "id": "697e40ec-785c-4df8-8608-0638775c082a",
      "brand": null,
      "status": "Halal",
      "company": "CV. MITRA SUPLINDO PERTANIAN",
      "issueDate": "21 May 2026",
      "certNumber": "ID32110072920370526",
      "validUntil": null,
      "productName": "Indomie Goreng Telur",
      "productType": null
    },
    {
      "id": "d9039944-3076-4b08-95bd-a094cd896214",
      "brand": null,
      "status": "Halal",
      "company": "CV. MITRA SUPLINDO PERTANIAN",
      "issueDate": "21 May 2026",
      "certNumber": "ID32110072920370526",
      "validUntil": null,
      "productName": "Indomie Goreng Bakso",
      "productType": null
    },
    {
      "id": "34abfe74-59d1-4d86-9027-d472717348f5",
      "brand": null,
      "status": "Halal",
      "company": "CV. MITRA SUPLINDO PERTANIAN",
      "issueDate": "21 May 2026",
      "certNumber": "ID32110072920370526",
      "validUntil": null,
      "productName": "Indomie Goreng Spesial",
      "productType": null
    }
  ]
}
```

---

## Cek Kode Pos

**Category:** indonesia · **Slug:** `cek-kode-pos`
**Detail page:** https://zpi.web.id/api/indonesia/cek-kode-pos

Cari kode pos Indonesia berdasarkan nama kelurahan, kecamatan, atau kota.

**Tags:** indonesia, kodepos, alamat, wilayah

### Lookup Kode Pos

Cari kode pos berdasarkan kata kunci kelurahan/kecamatan/kota.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:cek-kode-pos/lookup`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Nama kelurahan/kecamatan/kota yang akan dicari (min 2 char). |
| `limit` | number | query | no | Jumlah maksimum hasil yang dikembalikan. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:cek-kode-pos/lookup?query=Menteng&limit=20" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:cek-kode-pos/lookup?query=Menteng&limit=20", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:cek-kode-pos/lookup?query=Menteng&limit=20",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ok": true,
  "count": 20,
  "query": "Menteng",
  "results": [
    {
      "kota": "Serang",
      "kodePos": "42174",
      "provinsi": "Banten",
      "tipeKota": "Kab.",
      "kecamatan": "Tunjung Teja",
      "kelurahan": "Bojong Menteng"
    },
    {
      "kota": "Bekasi",
      "kodePos": "17117",
      "provinsi": "Jawa Barat",
      "tipeKota": "Kota",
      "kecamatan": "Rawalumbu",
      "kelurahan": "Bojongmenteng (Bojong Menteng)"
    },
    {
      "kota": "Lebak",
      "kodePos": "42362",
      "provinsi": "Banten",
      "tipeKota": "Kab.",
      "kecamatan": "Leuwidamar",
      "kelurahan": "Bojongmenteng (Bojong Menteng)"
    },
    {
      "kota": "Jakarta Pusat",
      "kodePos": "10330",
      "provinsi": "DKI Jakarta",
      "tipeKota": "Kota",
      "kecamatan": "Menteng",
      "kelurahan": "Cikini"
    },
    {
      "kota": "Sukabumi",
      "kodePos": "43182",
      "provinsi": "Jawa Barat",
      "tipeKota": "Kab.",
      "kecamatan": "Curugkembar",
      "kelurahan": "Cimenteng"
    },
    {
      "kota": "Subang",
      "kodePos": "41286",
      "provinsi": "Jawa Barat",
      "tipeKota": "Kab.",
      "kecamatan": "Cijambe",
      "kelurahan": "Cimenteng"
    },
    {
      "kota": "Cianjur",
      "kodePos": "43263",
      "provinsi": "Jawa Barat",
      "tipeKota": "Kab.",
      "kecamatan": "Campaka",
      "kelurahan": "Cimenteng"
    },
    {
      "kota": "Lebak",
      "kodePos": "42357",
      "provinsi": "Banten",
      "tipeKota": "Kab.",
      "kecamatan": "Cibadak",
      "kelurahan": "Cimenteng Jaya"
    },
    {
      "kota": "Jakarta Pusat",
      "kodePos": "10350",
      "provinsi": "DKI Jakarta",
      "tipeKota": "Kota",
      "kecamatan": "Menteng",
      "kelurahan": "Gondangdia"
    },
    {
      "kota": "Jakarta Pusat",
      "kodePos": "10340",
      "provinsi": "DKI Jakarta",
      "tipeKota": "Kota",
      "kecamatan": "Menteng",
      "kelurahan": "Kebon Sirih"
    },
    {
      "kota": "Palangkaraya",
      "kodePos": "73111",
      "provinsi": "Kalimantan Tengah",
      "tipeKota": "Kota",
      "kecamatan": "Jekan Raya",
      "kelurahan": "Menteng"
    },
    {
      "kota": "Bogor",
      "kodePos": "16111",
      "provinsi": "Jawa Barat",
      "tipeKota": "Kota",
      "kecamatan": "Bogor Barat",
      "kelurahan": "Menteng"
    },
    {
      "kota": "Jakarta Pusat",
      "kodePos": "10310",
      "provinsi": "DKI Jakarta",
      "tipeKota": "Kota",
      "kecamatan": "Menteng",
      "kelurahan": "Menteng"
    },
    {
      "kota": "Jakarta Selatan",
      "kodePos": "12960",
      "provinsi": "DKI Jakarta",
      "tipeKota": "Kota",
      "kecamatan": "Setiabudi (Setia Budi)",
      "kelurahan": "Menteng Atas"
    },
    {
      "kota": "Jakarta Selatan",
      "kodePos": "12870",
      "provinsi": "DKI Jakarta",
      "tipeKota": "Kota",
      "kecamatan": "Tebet",
      "kelurahan": "Menteng Dalam"
    },
    {
      "kota": "Kapuas",
      "kodePos": "73593",
      "provinsi": "Kalimantan Tengah",
      "tipeKota": "Kab.",
      "kecamatan": "Dadahup",
      "kelurahan": "Menteng Karya"
    },
    {
      "kota": "Cianjur",
      "kodePos": "43291",
      "provinsi": "Jawa Barat",
      "tipeKota": "Kab.",
      "kecamatan": "Cikalongkulon",
      "kelurahan": "Mentengsari"
    },
    {
      "kota": "Jakarta Pusat",
      "kodePos": "10320",
      "provinsi": "DKI Jakarta",
      "tipeKota": "Kota",
      "kecamatan": "Menteng",
      "kelurahan": "Pegangsaan"
    },
    {
      "kota": "Jakarta Timur",
      "kodePos": "13960",
      "provinsi": "DKI Jakarta",
      "tipeKota": "Kota",
      "kecamatan": "Cakung",
      "kelurahan": "Ujung Menteng"
    },
    {
      "kota": "Bogor",
      "kodePos": "16740",
      "provinsi": "Jawa Barat",
      "tipeKota": "Kab.",
      "kecamatan": "Cijeruk",
      "kelurahan": "Warung Menteng"
    }
  ]
}
```

---

## Cek NIK

**Category:** indonesia · **Slug:** `cek-nik`
**Detail page:** https://zpi.web.id/api/indonesia/cek-nik

Decode structural information from a 16-digit Indonesian NIK identifier.

**Tags:** utility, nik, indonesia, ktp

### Decode NIK

Decode province, district, birth date, and gender from NIK.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:cek-nik/decode`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `nik` | string | query | yes | NIK KTP Indonesia (16 digit angka) |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:cek-nik/decode?nik=3201011503900001" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:cek-nik/decode?nik=3201011503900001", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:cek-nik/decode?nik=3201011503900001",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ok": true,
  "nik": "3201011503900001",
  "birth": {
    "day": 15,
    "date": "1990-03-15",
    "year": 1990,
    "month": 3
  },
  "valid": true,
  "gender": "LAKI-LAKI",
  "source": "algorithmic",
  "kec_code": "01",
  "province": "Jawa Barat",
  "sequence": "0001",
  "kab_kota_code": "01",
  "province_code": "32"
}
```

---

## LPSE / Tender Pemerintah

**Category:** indonesia · **Slug:** `lpse`
**Detail page:** https://zpi.web.id/api/indonesia/lpse

Data tender & pengadaan pemerintah Indonesia dari sumber nasional (Satu Data LKPP). Cari paket tender lintas instansi, lihat detail tender (pagu/HPS/jadwal/anggaran), dan direktori kode LPSE.

**Tags:** lpse, tender, pengadaan, pemerintah, indonesia, lkpp, government

### Cari Tender

Cari paket tender pemerintah per LPSE/instansi dengan filter keyword, kategori, status, dan tahun.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:lpse/search`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `lpseCode` | number | query | no | Kode LPSE/instansi (lihat endpoint lpse-directory). Wajib salah satu: lpseCode atau instansi |
| `instansi` | string | query | no | Nama instansi LPSE untuk auto-resolve kode (alternatif lpseCode) |
| `year` | number | query | no | Tahun anggaran. Default tahun berjalan |
| `keyword` | string | query | no | Kata kunci nama paket (opsional) |
| `category` | enum(all|konstruksi|barang|konsultansi|jasa-lainnya) | query | no | Filter kategori pekerjaan. Default all |
| `status` | enum(all|berjalan|selesai|gagal|ditutup) | query | no | Filter status tender. Default all |
| `page` | number | query | no | Halaman (mulai 1). Default 1 |
| `count` | number | query | no | Item per halaman. Default 25, max 100 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:lpse/search?lpseCode=11&instansi=kementerian%20keuangan&year=2025&keyword=jalan&category=all&status=all&page=1&count=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:lpse/search?lpseCode=11&instansi=kementerian%20keuangan&year=2025&keyword=jalan&category=all&status=all&page=1&count=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:lpse/search?lpseCode=11&instansi=kementerian%20keuangan&year=2025&keyword=jalan&category=all&status=all&page=1&count=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "lpse": "LPSE Kementerian Keuangan",
  "page": 1,
  "year": 2025,
  "count": 25,
  "items": [
    {
      "hps": 302150000,
      "lpse": "LPSE Kementerian Keuangan",
      "pagu": 577107860,
      "lokasi": "Batuphat Barat, Muara Satu, Lhokseumawe (Kota), Aceh",
      "satker": "KANTOR PENGAWASAN DAN PELAYANAN BC LHOK SEUMAWE",
      "status": "Tender Sedang Berjalan",
      "instansi": "Kementerian Keuangan",
      "kategori": "Jasa Konsultansi Badan Usaha Konstruksi",
      "namaPaket": "Pengadaan Jasa Konsultansi Perencanaan Renovasi Mess KPPBC TMP C Lhokseumawe TA 2025",
      "kodeTender": "10021706000",
      "jumlahPenawar": null,
      "tanggalTayang": "2025-03-25 16:00:00",
      "jumlahPendaftar": null,
      "metodePemilihan": "Seleksi"
    },
    {
      "hps": 265770000,
      "lpse": "LPSE Kementerian Keuangan",
      "pagu": 326927000,
      "lokasi": "Jalan Sumatera No.III/52-53, Sumbersari,Jember, Jember (Kab.), Jawa Timur",
      "satker": "KANTOR PENGAWASAN DAN PELAYANAN BC JEMBER",
      "status": "Tender Sedang Berjalan",
      "instansi": "Kementerian Keuangan",
      "kategori": "Jasa Konsultansi Badan Usaha Konstruksi",
      "namaPaket": "Pengadaan Konsultan Perencana Pembangunan Mess Pegawai KPPBC TMP C Jember Tahun Anggaran 2025",
      "kodeTender": "41443011",
      "jumlahPenawar": null,
      "tanggalTayang": "2024-11-21 09:00:00",
      "jumlahPendaftar": null,
      "metodePemilihan": "Seleksi"
    },
    {
      "hps": 287733090.9,
      "lpse": "LPSE Kementerian Keuangan",
      "pagu": 364000000,
      "lokasi": "Pondok Bambu, Jakarta Timur (Kota), DKI Jakarta",
      "satker": "KANTOR PUSAT DIREKTORAT JENDERAL BEA DAN CUKAI",
      "status": "Tender Sedang Berjalan",
      "instansi": "Kementerian Keuangan",
      "kategori": "Jasa Konsultansi Badan Usaha Konstruksi",
      "namaPaket": "Pengadaan Jasa Konsultansi Perencana Rehabilitasi Rumah Negara Pondok Bambu Kantor Pusat DJBC Tahun Anggaran 2025",
      "kodeTender": "10003146000",
      "jumlahPenawar": null,
      "tanggalTayang": "2024-12-10 14:00:00",
      "jumlahPendaftar": null,
      "metodePemilihan": "Seleksi"
    },
    {
      "hps": 305883122,
      "lpse": "LPSE Kementerian Keuangan",
      "pagu": 306000000,
      "lokasi": "Jalan Mayor Abdurahman No. 221, Kotakaler, Sumedang Utara, Sumedang, Sumedang (Kab.), Jawa Barat",
      "satker": "KANTOR PELAYANAN PAJAK PRATAMA SUMEDANG",
      "status": "Tender Sedang Berjalan",
      "instansi": "Kementerian Keuangan",
      "kategori": "Jasa Konsultansi Badan Usaha Konstruksi",
      "namaPaket": "PENGADAAN JASA KONSULTANSI PENGAWASAN KONSTRUKSI PEMBANGUNAN LANJUTAN GEDUNG KANTOR PELAYANAN PAJAK PRATAMA SUMEDANG TAHUN ANGGARAN 2025",
      "kodeTender": "10037854000",
      "jumlahPenawar": null,
      "tanggalTayang": "2025-06-05 13:00:00",
      "jumlahPendaftar": null,
      "metodePemilihan": "Seleksi"
    },
    {
      "hps": 3317512419,
      "lpse": "LPSE Kementerian Keuangan",
      "pagu": 3321600000,
      "lokasi": "Komplek Pajak Kemanggisan, Jakarta Barat (Kota), DKI Jakarta",
      "satker": "KANTOR PUSAT DIREKTORAT JENDERAL PAJAK",
      "status": "Tender Sedang Berjalan",
      "instansi": "Kementerian Keuangan",
      "kategori": "Jasa Konsultansi Badan Usaha Konstruksi",
      "namaPaket": "Pengadaan Jasa Konsultansi Manajemen Konstruksi Pembangunan Rumah Susun Negara Kementerian Keuangan (Kontrak Tahun Jamak Tahun Anggaran 2024 dan 2025)",
      "kodeTender": "39295011",
      "jumlahPenawar": null,
      "tanggalTayang": "2024-01-15 13:00:00",
      "jumlahPendaftar": null,
      "metodePemilihan": "Seleksi"
    },
    {
      "hps": 367262764,
      "lpse": "LPSE Kementerian Keuangan",
      "pagu": 462000000,
      "lokasi": "Jl. Komp. Bea Cukai No.6, Pisangan, Kec. Ciputat Timur, Tangerang Selatan (Kota), Banten",
      "satker": "KANTOR PUSAT DIREKTORAT JENDERAL BEA DAN CUKAI",
      "status": "Tender Sedang Berjalan",
      "instansi": "Kementerian Keuangan",
      "kategori": "Jasa Konsultansi Badan Usaha Konstruksi",
      "namaPaket": "Pengadaan Jasa Konsultansi Pengawas Renovasi Rumah Negara Cirendeu Kantor Pusat Direktorat Jenderal Bea dan Cukai Tahun Anggaran 2025",
      "kodeTender": "10018559000",
      "jumlahPenawar": null,
      "tanggalTayang": "2025-03-14 14:00:00",
      "jumlahPendaftar": null,
      "metodePemilihan": "Seleksi"
    },
    {
      "hps": 418895000,
      "lpse": "LPSE Kementerian Keuangan",
      "pagu": 575500000,
      "lokasi": "Kudus, Kudus (Kab.), Jawa Tengah",
      "satker": "KANTOR PENGAWASAN DAN PELAYANAN BEA DAN CUKAI TIPE MADYA CUKAI KUDUS",
      "status": "Tender Sedang Berjalan",
      "instansi": "Kementerian Keuangan",
      "kategori": "Jasa Konsultansi Badan Usaha Konstruksi",
      "namaPaket": "Pengadaan Jasa Konsultansi Perencanaan Pembangunan Mess KPPBC TMC Kudus TA 2025",
      "kodeTender": "41435011",
      "jumlahPenawar": null,
      "tanggalTayang": "2024-11-11 15:00:00",
      "jumlahPendaftar": null,
      "metodePemilihan": "Seleksi"
    },
    {
      "hps": 471922497,
      "lpse": "LPSE Kementerian Keuangan",
      "pagu": 804276000,
      "lokasi": "Jl. Raya Situbondo NO 37, Banyuwangi (Kab.), Jawa Timur",
      "satker": "KANTOR PENGAWASAN DAN PELAYANAN BEA DAN CUKAI TIPE MADYA PABEAN C BANYUWANGI",
      "status": "Tender Sedang Berjalan",
      "instansi": "Kementerian Keuangan",
      "kategori": "Jasa Konsultansi Badan Usaha Konstruksi",
      "namaPaket": "Pengadaan Jasa Konsultansi Perencana Mess Pegawai Kantor Pengawasan dan Pelayanan Bea dan Cukai Tipe Madya Pabean C Banyuwangi Tahun Anggaran 2025",
      "kodeTender": "41312011",
      "jumlahPenawar": null,
      "tanggalTayang": "2024-11-05 15:00:00",
      "jumlahPendaftar": null,
      "metodePemilihan": "Seleksi"
    }
  ],
  "total": 548,
  "status": "all",
  "hasMore": true,
  "category": "all",
  "lpseCode": 11,
  "nextPage": 2,
  "provider": "lpse",
  "returned": 25
}
```

---

### Detail Tender

Detail lengkap satu tender (pagu, HPS, metode, jadwal, anggaran, lokasi) dari kode tender + kode LPSE + tahun.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:lpse/detail`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `kodeTender` | string | query | yes | Kode tender (dari endpoint tender-list) |
| `lpseCode` | number | query | yes | Kode LPSE pemilik tender (dari tender-list) |
| `year` | number | query | yes | Tahun anggaran tender |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:lpse/detail?kodeTender=10006621000&lpseCode=11&year=2025" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:lpse/detail?kodeTender=10006621000&lpseCode=11&year=2025", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:lpse/detail?kodeTender=10006621000&lpseCode=11&year=2025",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "hps": 302150000,
  "lpse": "LPSE Kementerian Keuangan",
  "pagu": 577107860,
  "lokasi": [
    {
      "detail": "Batuphat Barat, Muara Satu",
      "provinsi": "Aceh",
      "kabupatenKota": "Lhokseumawe (Kota)"
    }
  ],
  "status": "Tender Sedang Berjalan",
  "anggaran": [
    {
      "nilai": 577107860,
      "rupId": 58664821,
      "tahun": 2025,
      "sumberDana": "APBN",
      "kodeRekening": "015.05.WA.4695.EBB.005.100.RB.533121"
    }
  ],
  "kategori": "Jasa Konsultansi Badan Usaha Konstruksi",
  "lpseCode": 11,
  "provider": "lpse",
  "namaPaket": "Pengadaan Jasa Konsultansi Perencanaan Renovasi Mess KPPBC TMP C Lhokseumawe TA 2025",
  "kodeTender": "10021706000",
  "jumlahPenawar": null,
  "tanggalDibuat": "2025-03-25",
  "tanggalTayang": "2025-03-25 16:00:00",
  "caraPembayaran": "Lumsum",
  "instansiSatker": [
    {
      "rupId": 58664821,
      "satker": "KANTOR PENGAWASAN DAN PELAYANAN BC LHOK SEUMAWE",
      "paketId": 10021229000,
      "instansi": "Kementerian Keuangan",
      "jenisInstansi": "KEMENTERIAN"
    }
  ],
  "metodeEvaluasi": "Pagu Anggaran",
  "jadwalPenawaran": {
    "akhir": "2025-04-09",
    "mulai": "2025-03-28"
  },
  "jumlahPendaftar": null,
  "metodePemilihan": "Seleksi",
  "metodePengadaan": "Pra Dua File Kualitas Biaya",
  "durasiTenderHari": 66,
  "jadwalPengumuman": {
    "akhir": "2025-04-09",
    "mulai": "2025-03-25"
  },
  "paketKonsolidasi": false,
  "jenisPenetapanPemenang": "Tender Non Itemized",
  "jumlahKirimKualifikasi": 0
}
```

---

### Direktori LPSE

Daftar/cari kode LPSE & instansi (helper untuk memperoleh lpseCode).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:lpse/directory`
- **Cache TTL:** 1800s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `keyword` | string | query | no | Kata kunci nama LPSE/instansi (opsional) |
| `page` | number | query | no | Halaman (mulai 1). Default 1 |
| `count` | number | query | no | Item per halaman. Default 50, max 100 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:lpse/directory?keyword=kementerian&page=1&count=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:lpse/directory?keyword=kementerian&page=1&count=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:lpse/directory?keyword=kementerian&page=1&count=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 50,
  "items": [
    {
      "nama": "LPSE Kementerian Keuangan",
      "lpseCode": 11,
      "updatedAt": "2026-01-16"
    },
    {
      "nama": "LPSE Kementerian Pendidikan dan Kebudayaan",
      "lpseCode": 25,
      "updatedAt": "2026-01-16"
    },
    {
      "nama": "LPSE Kementerian Pekerjaan Umum dan Perumahan Rakyat",
      "lpseCode": 64,
      "updatedAt": "2026-01-16"
    },
    {
      "nama": "LPSE Kementerian Agraria dan Tata Ruang/BPN",
      "lpseCode": 65,
      "updatedAt": "2026-01-16"
    },
    {
      "nama": "LPSE Kementerian Dalam Negeri",
      "lpseCode": 105,
      "updatedAt": "2026-01-16"
    },
    {
      "nama": "LPSE Kementerian Energi dan Sumber Daya Mineral",
      "lpseCode": 109,
      "updatedAt": "2026-01-16"
    },
    {
      "nama": "LPSE Kementerian Perhubungan",
      "lpseCode": 114,
      "updatedAt": "2026-01-16"
    },
    {
      "nama": "LPSE Kementerian Perindustrian",
      "lpseCode": 126,
      "updatedAt": "2026-01-16"
    }
  ],
  "total": 26,
  "hasMore": false,
  "keyword": "kementerian",
  "nextPage": null,
  "provider": "lpse",
  "returned": 26
}
```

---

## SIPP Mahkamah Agung

**Category:** indonesia · **Slug:** `sipp`
**Detail page:** https://zpi.web.id/api/indonesia/sipp

Penelusuran perkara pengadilan Indonesia (SIPP, Mahkamah Agung). Cari perkara per pengadilan berdasarkan nomor/pihak/klasifikasi dan lihat detail perkara. Ketersediaan per-pengadilan bervariasi (sebagian ke-gate captcha/CF).

**Tags:** sipp, mahkamah-agung, perkara, pengadilan, hukum, indonesia, court

### Cari Perkara

Cari/daftar perkara pada satu pengadilan (kode subdomain) berdasarkan nomor perkara, nama pihak, atau klasifikasi.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:sipp/search`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `court` | string | query | yes | Kode pengadilan (subdomain, mis. pn-surabayakota, pn-jakartapusat, pa-bandung) atau host lengkap |
| `query` | string | query | no | Kata kunci pencarian (nomor perkara / nama pihak / klasifikasi). Kosong = daftar perkara terbaru |
| `page` | number | query | no | Nomor halaman (1-based, 20 item/halaman), default 1, max 50 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:sipp/search?court=pn-surabayakota&query=Pdt.G&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:sipp/search?court=pn-surabayakota&query=Pdt.G&page=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:sipp/search?court=pn-surabayakota&query=Pdt.G&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 20,
  "court": "sipp.pn-jakartautara.go.id",
  "items": [
    {
      "status": "Minutasi",
      "parties": {
        "pelanggar": [
          "Hasan Nurahman"
        ]
      },
      "detailUrl": "https://sipp.pn-jakartautara.go.id/show_detil/a2JJNTdielJFejIrVXZ2YWU1NEQraVR1VDRyWmd6VGpoTDJmeXJCZGp0UzdXN1k4S1liUzEvYVBmMjJHdXZKZjNvMUZqbFJvYzNhTmV5M0U5eEhZelE9PQ==",
      "caseNumber": "24480/Pid.LL/2026/PN Jkt.Utr",
      "detailToken": "a2JJNTdielJFejIrVXZ2YWU1NEQraVR1VDRyWmd6VGpoTDJmeXJCZGp0UzdXN1k4S1liUzEvYVBmMjJHdXZKZjNvMUZqbFJvYzNhTmV5M0U5eEhZelE9PQ==",
      "registerDate": "12 Jun 2026",
      "classification": "Perkara Lalu-Lintas",
      "processDuration": "1 Hari"
    },
    {
      "status": "Minutasi",
      "parties": {
        "pelanggar": [
          "Hartoni"
        ]
      },
      "detailUrl": "https://sipp.pn-jakartautara.go.id/show_detil/OHh6WFl4NVVZR2o4OElNak9tU052aWhJOXJzeGFLTTNsSzQwRjFldTNNR1dwU2dPNHlZb2lEUGFmRE8wQXdHeFIxbDhWWW9HNTcyOStPMHBPMFlPeHc9PQ==",
      "caseNumber": "24736/Pid.LL/2026/PN Jkt.Utr",
      "detailToken": "OHh6WFl4NVVZR2o4OElNak9tU052aWhJOXJzeGFLTTNsSzQwRjFldTNNR1dwU2dPNHlZb2lEUGFmRE8wQXdHeFIxbDhWWW9HNTcyOStPMHBPMFlPeHc9PQ==",
      "registerDate": "12 Jun 2026",
      "classification": "Perkara Lalu-Lintas",
      "processDuration": "1 Hari"
    },
    {
      "status": "Minutasi",
      "parties": {
        "pelanggar": [
          "Vernon . S"
        ]
      },
      "detailUrl": "https://sipp.pn-jakartautara.go.id/show_detil/YURpNzdOYk1TNm9UV0hnUVpMdnhuOEhvVHBETlpkR2lPZmN3YUpHNW1LMDFOZG42NW8vbjFNbmw3Q1Nub00zM1Z2cFRodVQxT0VrdVBxQWRlbG1EZ1E9PQ==",
      "caseNumber": "24992/Pid.LL/2026/PN Jkt.Utr",
      "detailToken": "YURpNzdOYk1TNm9UV0hnUVpMdnhuOEhvVHBETlpkR2lPZmN3YUpHNW1LMDFOZG42NW8vbjFNbmw3Q1Nub00zM1Z2cFRodVQxT0VrdVBxQWRlbG1EZ1E9PQ==",
      "registerDate": "12 Jun 2026",
      "classification": "Perkara Lalu-Lintas",
      "processDuration": "1 Hari"
    },
    {
      "status": "Minutasi",
      "parties": {
        "pelanggar": [
          "Hasan Nurahman"
        ]
      },
      "detailUrl": "https://sipp.pn-jakartautara.go.id/show_detil/bFgydWVxZWw5ZkkwaXRidWZyRGJ6SXg3Rm5uR2pXUEd4b3duaW9GbnZrelFKVFVYT3hBaHg3OXpnUXFHZDRFcGZpdFhQMFUzMXB5MUJoeFpsRU1rV1E9PQ==",
      "caseNumber": "24481/Pid.LL/2026/PN Jkt.Utr",
      "detailToken": "bFgydWVxZWw5ZkkwaXRidWZyRGJ6SXg3Rm5uR2pXUEd4b3duaW9GbnZrelFKVFVYT3hBaHg3OXpnUXFHZDRFcGZpdFhQMFUzMXB5MUJoeFpsRU1rV1E9PQ==",
      "registerDate": "12 Jun 2026",
      "classification": "Perkara Lalu-Lintas",
      "processDuration": "1 Hari"
    },
    {
      "status": "Minutasi",
      "parties": {
        "pelanggar": [
          "Ang Sin To"
        ]
      },
      "detailUrl": "https://sipp.pn-jakartautara.go.id/show_detil/L1JGYXlBOExVY3pKREFVNzRLN0pUM0Z6c1RIMGxWUUsxRlBaZGJ5RXNtYXZOSVNWaklDSEtEMUhxRW5MWWpSZWxOcjlSdEx4S3ByaFJJUTR2MHVqUUE9PQ==",
      "caseNumber": "24737/Pid.LL/2026/PN Jkt.Utr",
      "detailToken": "L1JGYXlBOExVY3pKREFVNzRLN0pUM0Z6c1RIMGxWUUsxRlBaZGJ5RXNtYXZOSVNWaklDSEtEMUhxRW5MWWpSZWxOcjlSdEx4S3ByaFJJUTR2MHVqUUE9PQ==",
      "registerDate": "12 Jun 2026",
      "classification": "Perkara Lalu-Lintas",
      "processDuration": "1 Hari"
    },
    {
      "status": "Minutasi",
      "parties": {
        "pelanggar": [
          "Sugianto"
        ]
      },
      "detailUrl": "https://sipp.pn-jakartautara.go.id/show_detil/U2NoV2RWMXlVYzNJcDZ0ZzV0Ry9DakZyZm00SGF2Vm1mTzFFMkVZbVpBYmNPTzg2ellIR2c1dEZxaHMzbHJkYVRWN2JJUlc4RksxU3Jna25tMEt2S1E9PQ==",
      "caseNumber": "24993/Pid.LL/2026/PN Jkt.Utr",
      "detailToken": "U2NoV2RWMXlVYzNJcDZ0ZzV0Ry9DakZyZm00SGF2Vm1mTzFFMkVZbVpBYmNPTzg2ellIR2c1dEZxaHMzbHJkYVRWN2JJUlc4RksxU3Jna25tMEt2S1E9PQ==",
      "registerDate": "12 Jun 2026",
      "classification": "Perkara Lalu-Lintas",
      "processDuration": "1 Hari"
    },
    {
      "status": "Minutasi",
      "parties": {
        "pelanggar": [
          "Benediktus Billiu"
        ]
      },
      "detailUrl": "https://sipp.pn-jakartautara.go.id/show_detil/b0hvekhzT1ovNFdoN21JNEx1M3hMRWQ2cWNoV25vTjRuS2ExblZmK3ZiTm5NemJGUXZrSmQ4MFhJNjFLV3drdjQxak9SemhxNWk5ci8vcUE0clhwTmc9PQ==",
      "caseNumber": "24482/Pid.LL/2026/PN Jkt.Utr",
      "detailToken": "b0hvekhzT1ovNFdoN21JNEx1M3hMRWQ2cWNoV25vTjRuS2ExblZmK3ZiTm5NemJGUXZrSmQ4MFhJNjFLV3drdjQxak9SemhxNWk5ci8vcUE0clhwTmc9PQ==",
      "registerDate": "12 Jun 2026",
      "classification": "Perkara Lalu-Lintas",
      "processDuration": "1 Hari"
    },
    {
      "status": "Minutasi",
      "parties": {
        "pelanggar": [
          "Ang Sin To"
        ]
      },
      "detailUrl": "https://sipp.pn-jakartautara.go.id/show_detil/SzFUeWNrV21kRjVKTzQ0b290SXJ5ZVNZRTBOZitOTWxxTUxWbDFSbVIrdXlrdzNNZ3pvT2J5Z1VJTXY2dC8wajFDMW80WjVhRGdmeWUvbzAxRGhDV3c9PQ==",
      "caseNumber": "24738/Pid.LL/2026/PN Jkt.Utr",
      "detailToken": "SzFUeWNrV21kRjVKTzQ0b290SXJ5ZVNZRTBOZitOTWxxTUxWbDFSbVIrdXlrdzNNZ3pvT2J5Z1VJTXY2dC8wajFDMW80WjVhRGdmeWUvbzAxRGhDV3c9PQ==",
      "registerDate": "12 Jun 2026",
      "classification": "Perkara Lalu-Lintas",
      "processDuration": "1 Hari"
    }
  ],
  "query": null,
  "hasMore": true,
  "nextPage": 2
}
```

---

### Detail Perkara

Detail satu perkara (klasifikasi, status, jadwal, para pihak) dari detailToken hasil pencarian.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/indonesia:sipp/detail`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `court` | string | query | yes | Kode pengadilan (subdomain) atau host lengkap |
| `token` | string | query | yes | detailToken dari endpoint pencarian perkara (bagian setelah show_detil/) |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/indonesia:sipp/detail?court=pn-surabayakota&token=YnFZbzVMNmUwYlhPd2FQQmFkWUp0cndSYy9PRXMrQnNPNkJmaG9sUFlic1NoTm55dGx1MGhLd0V1cjcyeHhXcHk4OU5jZ3p2enc3RVBNY05VZC9SbEE9PQ%3D%3D" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/indonesia:sipp/detail?court=pn-surabayakota&token=YnFZbzVMNmUwYlhPd2FQQmFkWUp0cndSYy9PRXMrQnNPNkJmaG9sUFlic1NoTm55dGx1MGhLd0V1cjcyeHhXcHk4OU5jZ3p2enc3RVBNY05VZC9SbEE9PQ%3D%3D", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/indonesia:sipp/detail?court=pn-surabayakota&token=YnFZbzVMNmUwYlhPd2FQQmFkWUp0cndSYy9PRXMrQnNPNkJmaG9sUFlic1NoTm55dGx1MGhLd0V1cjcyeHhXcHk4OU5jZ3p2enc3RVBNY05VZC9SbEE9PQ%3D%3D",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "court": "sipp.pn-jakartautara.go.id",
  "status": "Minutasi",
  "caseNumber": "24480/Pid.LL/2026/PN Jkt.Utr",
  "sippVersion": "6.1.9-1",
  "registerDate": "Jumat, 12 Jun. 2026",
  "classification": "Perkara Lalu-Lintas",
  "partiesPublished": "Ya"
}
```

---