統編 API:以統一編號查詢台灣公司

輸入統一編號、營業稅號碼或公司名稱,以 JSON 取得台灣公司的名稱、組織型態、狀況、資本額與登記地址。資料合併經濟部的公司登記與財政部的營業稅籍登記。

為什麼要自己整合兩個來源

台灣公司的官方資料分散在兩個部會。經濟部(透過商工行政資料開放平臺)公布公司登記:名稱、組織型態、公司狀況、資本額與核准設立日期。財政部財政資訊中心公布全國營業(稅籍)登記資料集:稅務行業標準分類、營業稅狀態與縣市。兩者共用同一組 8 碼統一編號,但格式與更新方式不同。Prometiam 把兩個來源合併成與其他國家相同的 JSON 公司物件,你只需要用 country=TW 呼叫。

三種查詢方式

  • 統一編號:company_number=22099131。保留開頭的 0(例如 04541302);只有 7 碼時會在前面補 0。前面加 TW 或使用全形數字也可讀取。
  • 營業稅號碼:vat=22099131。對於在財政部稅籍資料中的公司,營業稅號碼就是統一編號;不在稅籍資料中的公司,vat_number 為空值。
  • 公司名稱:name=台積電。搜尋時「臺」與「台」視為同一字。名稱是繁體中文,沒有英文名稱,所以不能用英文名稱搜尋。

curl 與 Python 範例

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=TW&company_number=22099131' \
  -H 'Authorization: Bearer rk_live_...'
import requests

r = requests.get(
    'https://api.prometiam.com/functions/v1/risk-api/companies/search',
    params={'country': 'TW', 'name': '宏碁'},
    headers={'Authorization': 'Bearer rk_live_...'},
    timeout=30,
)
for c in r.json()['data']:
    print(c['company_number'], c['company_name'], c['status'])

回應如下(節錄,實際物件包含完整的標準公司欄位)。

{
  "data": [{
    "country": "TW",
    "company_number": "22099131",
    "company_name": "台灣積體電路製造股份有限公司",
    "status": "active",
    "local_status": "核准設立",
    "activity_code": "261199",
    "activity_code_scheme": "TW-TAX-SIC",
    "region": "新竹市"
  }]
}

回傳的欄位

欄位說明
company_number8 碼統一編號,保留開頭的 0。
company_name繁體中文的登記名稱。沒有英文名稱。
legal_form、local_status組織型態(有限公司、股份有限公司等)與登記機關的狀況用語(核准設立、解散、撤銷等)。
status標準狀況:active、in_dissolution(解散)、重整、破產,以及 deregistered(撤銷或廢止登記)。
capital_amount、paid_in_capital資本總額與實收資本額(新臺幣)。
founding_date核准設立日期。
address、region登記地址(中文)與縣市。
activity_code、activity_code_scheme財政部稅務行業標準分類(6 碼),分類代號為 TW-TAX-SIC。這不是 NACE,nace_code 維持空白。
vat_number在稅籍資料中的公司,其營業稅號碼即為統一編號,否則為空值。

涵蓋與不涵蓋

提供有限公司、股份有限公司、無限公司、兩合公司,以及外國公司在台分公司的公司紀錄。獨資與合夥商號(商業登記)、國內分公司、合作社、社團與辦事處一律不提供,所以查詢這些組織的統編不會有結果,即使它們確實存在。

  • 沒有董監事與負責人資料,也沒有破產公告;解散、重整與破產會顯示在 status。
  • 沒有英文名稱,也沒有 NACE 代碼。
  • 另提供登記變更事件(名稱、狀況、組織型態與地址的變更,以變更首次出現在登記資料中的日期為準,2026 年 10 月首次載入之前沒有資料)與公司監控;登記資料每日讀取。

統編檢查碼只作參考

統編的檢查規則在 2023 年修改過(詳見統編查詢的說明)。API 以 8 碼格式為準,檢查碼不符的號碼仍會被查詢,不會回傳 400,因為少數早年解散的編號兩種規則都不符。你的表單若自行檢核,請確認已更新為現行規則,否則 2023 年後核發的新統編可能被誤判為錯誤。

價格

每取得一筆公司紀錄為 1 點數。14 天免費試用含 500 點數,需要信用卡,試用期間不會扣款;之後可選 Starter(每月 9.99 歐元,1,000 點數)。請見價格。

Contains data from the Ministry of Economic Affairs, Department of Commerce (GCIS open data platform) and the Ministry of Finance, Fiscal Information Agency (business tax registration data), Republic of China (Taiwan), released under the Open Government Data License v1.0 (https://data.gov.tw/license). Adapted by Prometiam, not a certified register extract.

相關頁面

開始 14 天免費試用 · API 文件

試用期為 14 天,包含 500 點數。需要信用卡,試用期間不會扣款;若未取消,之後將改為 Starter 方案(每月 9.99 歐元)。

Frequently asked questions

如何用統編查詢台灣公司?
呼叫 GET /companies/search?company_number=22099131&country=TW,並帶上 API 金鑰。結果是 JSON,包含名稱、組織型態、狀況、資本額與登記地址。
可以用營業稅號碼查詢嗎?
可以,傳入 vat=22099131 與 country=TW。只有在財政部稅籍資料中的公司才有營業稅號碼,它等於統一編號。
有英文公司名稱嗎?
沒有。登記資料沒有英文名稱,名稱與地址都是繁體中文。「臺」與「台」視為同一字。
行業代碼是 NACE 嗎?
不是。這是財政部稅務行業標準分類(6 碼),分類代號為 TW-TAX-SIC,未對照到 NACE。
可以查到董監事或負責人嗎?
不行。台灣的資料以公司為單位,不提供董監事與負責人。需要這類資料請使用經濟部的商工登記公示資料查詢服務。