輸入統一編號、營業稅號碼或公司名稱,以 JSON 取得台灣公司的名稱、組織型態、狀況、資本額與登記地址。資料合併經濟部的公司登記與財政部的營業稅籍登記。
台灣公司的官方資料分散在兩個部會。經濟部(透過商工行政資料開放平臺)公布公司登記:名稱、組織型態、公司狀況、資本額與核准設立日期。財政部財政資訊中心公布全國營業(稅籍)登記資料集:稅務行業標準分類、營業稅狀態與縣市。兩者共用同一組 8 碼統一編號,但格式與更新方式不同。Prometiam 把兩個來源合併成與其他國家相同的 JSON 公司物件,你只需要用 country=TW 呼叫。
company_number=22099131。保留開頭的 0(例如 04541302);只有 7 碼時會在前面補 0。前面加 TW 或使用全形數字也可讀取。vat=22099131。對於在財政部稅籍資料中的公司,營業稅號碼就是統一編號;不在稅籍資料中的公司,vat_number 為空值。name=台積電。搜尋時「臺」與「台」視為同一字。名稱是繁體中文,沒有英文名稱,所以不能用英文名稱搜尋。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_number | 8 碼統一編號,保留開頭的 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。統編的檢查規則在 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 天,包含 500 點數。需要信用卡,試用期間不會扣款;若未取消,之後將改為 Starter 方案(每月 9.99 歐元)。