---
reviewed_by:
  rd: Ronny
  pm:
---
# 法人登記法院列表 — `tw.gov.judicial~ref~court`

> **給 AI 閱讀的使用指引。**
> 人類可在 https://data.openfun.tw/datasets/tw.gov.judicial~ref~court 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

## ⚠️ 開始之前（AI agent 必讀，摘要也請保留這段）

資料集 slug：tw.gov.judicial~ref~court
API 端點：https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~court/records
認證方式（必填）：HTTP Header  Authorization: Bearer {token}

最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~court/records"

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請停止並告訴使用者：「請先前往 https://data.openfun.tw/user 免費申請帳號與 API Token，取得後告訴我，我再幫您查詢。」

禁止抓取 HTML 頁面（本平台有 bot 保護，WebFetch 讀 HTML 頁面會失敗）。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／司法院」

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 司法院（[法人登記公告](https://www.judicial.gov.tw/tw/lp-144-1.html)） |
| 授權 | 政府資料開放授權條款 1.0 |
| 更新頻率 | 不定期（法院改制或新設時更新） |
| 總筆數 | 22 筆 |

---

## 這份資料集能回答什麼問題

此資料集為**代碼對照表**，主要作為 `tw.gov.judicial~ref~foundation-doc` 的法院代碼解碼用途。

- 「TPD 是哪個法院？」→ 臺灣臺北地方法院
- 法人公文編號前三碼（如 `TCD:`）對應的法院名稱

全部 22 筆，小資料集，可直接一次載入，不需逐筆查詢。

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `法院編號` | keyword（_id） | 法院編號 |
| `名稱` | text（_name） | 名稱 |

### 關鍵欄位補充說明

| 欄位 | 型別 | 重要說明 |
|------|------|---------|
| `法院編號` | keyword（_id） | 3–4 碼英文代碼，如 `TPD`；對應 `tw.gov.judicial~ref~foundation-doc` 的 `公文編號.法院編號` |
| `名稱` | text（_name） | 法院全名；全文搜尋：`?q=臺北` |

---

## 重要注意事項（查詢前必讀）

### ⚠️ 小資料集，建議一次全部載入

本資料集共 22 筆，建議直接取回全部記錄做本地查詢，不需逐筆呼叫 API：

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~court/records?per_page=50"
```

### ⚠️ 無 /agg 功能

兩個欄位均無 `filter: true`，/agg 端點對此資料集**無法使用**。

---

## API 呼叫範例

**Records URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~court/records`

### 取得全部法院代碼

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~court/records?per_page=50"
```

### 依代碼直接取單筆

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~court/records/TPD"
```

### 依名稱搜尋

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~court/records?q=臺北"
```

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.judicial~ref~foundation-doc`](../tw.gov.judicial~ref~foundation-doc/skill.md) | 法人登記公告詳細資料 | `公文編號.法院編號` 欄位使用本表代碼；以本表解碼法院名稱 |
| [`tw.gov.judicial~ref~foundation`](../tw.gov.judicial~ref~foundation/skill.md) | 法人基本資料 | 法人登記所在法院 |

---

## 注意事項與限制

1. **僅含地方法院**：本資料集收錄辦理法人登記的地方法院，不含高等法院或最高法院。
2. **代碼為英文縮寫**：格式為 3–4 碼大寫英文，精確比對時需完全一致（如 `TPD`，不可用 `tpd`）。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~court/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | https://data.openfun.tw/user |
| 取全部 | `?per_page=50`（共 22 筆） |
| 精確查單筆 | `/records/{法院編號}`，如 `/records/TPD` |
| 全文搜尋 | `?q=臺北` |
| /agg | ❌ 不支援（無可分組欄位） |
| Records 回應 | JSON，含 `total`、`page`、`per_page`、`records[]` |