---
reviewed_by:
  rd: Ronny
  pm:
---
# 法人列表 — `tw.gov.judicial~ref~foundation`

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

---

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

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

最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~foundation/records?q=基金會&per_page=10"

**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 |
| 更新頻率 | 每日 |
| 涵蓋範圍 | 全台各地方法院登記之財團法人、社團法人、政黨 |
| 總筆數 | 約 31,887 筆 |

---

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

以下問題，這份資料集**可以回答**：

- 「某財團法人/社團法人/政黨目前的法人編號是什麼？」
- 「某法人有幾次歷史變更記錄？」（透過 `歷程公告文號` 的長度）
- 「查詢法人名稱，取得最新登記資料的連結」（透過 `最新公告文號` 跳到 foundation-doc）

以下問題，這份資料集**無法回答**：

- 「某法人的地址、目的、財產、董事成員是什麼？」→ 請查 `tw.gov.judicial~ref~foundation-doc`，用最新公告文號查詢
- 「某法人是否已解散？」→ 請查 foundation-doc 最新那筆的案由欄位

> **使用模式**：本資料集是**入口**，找到法人後取得 `最新公告文號`，再到 `tw.gov.judicial~ref~foundation-doc` 查詳細內容。

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `法人編號` | keyword（_id） | 由法院編號和該法人第一次設立時的文號組成 |
| `名稱` | text（_name） | 名稱 |
| `類別` | keyword（篩選器） | 1-財團,2-社團,3-政黨 |
| `設立登記日期` | date | 設立登記日期 |
| `許可機關日期` | keyword | 許可機關日期 |
| `許可機關日期.主管機關` | keyword | 許可機關日期 |
| `主事務所` | keyword | 主事務所 |
| `主事務所.縣市` | keyword（篩選器、ref: tw.openfun~entity~geo） | 主事務所 |
| `主事務所.鄉鎮市區` | keyword（篩選器、ref: tw.openfun~entity~geo） | 主事務所 |
| `最新公告文號` | keyword（ref: tw.gov.judicial~ref~foundation-doc） | 最新公告文號 |
| `歷程公告文號` | keyword（多值、ref: tw.gov.judicial~ref~foundation-doc） | 歷程公告文號 |
| `法人編號.政黨編號` | keyword（ref: tw.gov.moi~ref~party） | 政黨編號 |
| `最新公告日期` | date | 最新公告日期 |

### 關鍵欄位補充說明

| 欄位 | 型別 | 重要說明 |
|------|------|---------|
| `法人編號` | keyword（_id） | 唯一識別碼，格式 `{法院編號}:{設立文號}`，如 `SLD:104法登財000019`；永久不變 |
| `名稱` | text（_name） | 法人最新名稱；全文搜尋：`?q=慈善基金會` |
| `最新公告文號` | keyword（ref） | 最近一次登記公告的文號；用此值到 foundation-doc 查詳細內容 |
| `歷程公告文號` | keyword[]（ref） | 從設立至今所有公告文號清單；長度代表歷次變更次數 |

---

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

### ⚠️ 本資料集只有名稱和文號索引

地址、財產、董事、目的、解散狀態等詳細欄位**均不在本資料集**，需以 `最新公告文號` 到 `tw.gov.judicial~ref~foundation-doc` 查詢。

### ⚠️ 社團法人資料不完整

社團法人依人民團體法第 11 條屬**自願**向法院辦理登記，本資料集僅收錄選擇向法院登記者，並非全台所有立案社團。財團法人與政黨為強制登記，資料應屬完整。

---

## API 呼叫範例

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

### 按名稱全文搜尋

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~foundation/records?q=慈善基金會&per_page=10"
```

### 兩步驟查法人詳細資料

**步驟 1：搜尋法人，取得最新公告文號**
```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~foundation/records?q=台灣紅十字&per_page=3"
```

**步驟 2：用最新公告文號查 foundation-doc**
```bash
# 將上一步取得的最新公告文號填入 {文號}
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~foundation-doc/records/{文號}"
```

### 分頁查詢

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

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.judicial~ref~foundation-doc`](../tw.gov.judicial~ref~foundation-doc/skill.md) | 法人每次登記的詳細公文內容 | 以 `最新公告文號` 查詢法人地址、目的、財產、董監事、是否解散 |
| [`tw.gov.judicial~ref~court`](../tw.gov.judicial~ref~court/skill.md) | 法院代碼對照表 | 解讀 `法人編號` 前綴的法院代碼 |

---

## 注意事項與限制

1. **只有名稱和文號索引**：詳細欄位（地址、財產、董事等）請到 `foundation-doc` 查詢。
2. **社團法人不完整**：僅含選擇向法院辦理法人登記的社團，不代表全台所有立案社團。
3. **法人編號永久不變**：即使法人改名，編號仍使用第一次設立時的文號。
4. **`歷程公告文號` 長度**：可用來估計法人歷次變更次數（含設立公告算 1 次）。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.judicial~ref~foundation/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | https://data.openfun.tw/user |
| 按名稱搜尋 | `?q=關鍵字` |
| 分頁 | `?page=1&per_page=20` |
| Records 回應 | JSON，含 `total`、`page`、`per_page`、`records[]` |