REST 說明文件
2019-10-08 更新
REST API概述
企業商務資料平台 REST API提供一套簡易的方式來存取企業商務資料平台的資料,並輸出json或xml格式。您也可以透過各種程式或工具快速取得需要的資料。
提示:
您可以直接使用瀏覽器(Browser)來取得資料,也可以透過工具程式例如 curl, wget ...等
分成以下三層API,包含
搜尋API(search api):
提供資料搜尋的功能,包含公司名稱、統一編號、住址搜尋,董監事名稱搜尋,集團搜尋...等功能。
報表API(report api):
提供整理後的公司資料、集團資料以及各類資料供應商的整合資料。
資料API(datatables api):
提供最基礎資料表格查詢與取得資料。
搜尋API使用方法(search api)
定義
GET https://kyc.tej.com.tw/api/search/{function}/{keyword}?api_key=<YOURAPIKEY>
第一階段提供幾項搜尋,後續將陸續推出新功能
- 公司名稱、統一編號、住址搜尋
- 董監事名稱搜尋
- 集團搜尋
[功能]搜尋公司名稱、統一編號、住址
GET https://kyc.tej.com.tw/api/search/company/{keyword}?api_key=<YOURAPIKEY>
針對公司名稱、統一編號、住址使用關鍵字搜尋,找出近似的結果。以【大西洋】為例
GET https://kyc.tej.com.tw/api/search/company/大西洋?api_key=<YOURAPIKEY>
另可以使用參數rows限定最大回應筆數
GET https://kyc.tej.com.tw/api/search/company/大西洋?api_key=<YOURAPIKEY>&rows=3
資料範例如下
{
"searchResults":[
{
"tej_comp_id":33702,
"comp_ban":"35012903",
"comp_id":"1213",
"comp_name":"大西洋飲料股份有限公司",
"comp_add":"新北市三重區幸福里30鄰重陽路3段99號10樓",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":566226270,
"paid_in_capital":566226270,
"set_date":"1965-07-24",
"chg_date":"2019-05-24",
"register_organ":"經濟部商業司"
},
{
"tej_comp_id":3056045,
"comp_ban":"01982016",
"comp_id":"",
"comp_name":"大西洋興業有限公司",
"comp_add":"新北市新莊區中正路新生巷14號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":1000000,
"paid_in_capital":null,
"set_date":"1985-10-11",
"chg_date":"2009-05-26",
"register_organ":"新北市政府"
},
{
"tej_comp_id":3069866,
"comp_ban":"04643928",
"comp_id":"",
"comp_name":"大西洋建設股份有限公司",
"comp_add":"臺北市大安區復興南路一段126巷1號9樓之9",
"comp_status":"撤銷",
"equity_status":"",
"capital_total":30000000,
"paid_in_capital":30000000,
"set_date":"1976-07-30",
"chg_date":"1991-04-01",
"register_organ":"經濟部商業司"
}
]
}
[功能]搜尋董監事名稱
GET https://kyc.tej.com.tw/api/search/director/{keyword}?api_key=<YOURAPIKEY>
針對董監事名稱使用關鍵字搜尋,找出近似的結果。以【施振榮】為例
GET https://kyc.tej.com.tw/api/search/director/施振榮?api_key=<YOURAPIKEY>
另可以使用參數rows限定最大回應筆數
GET https://kyc.tej.com.tw/api/search/director/施振榮?api_key=<YOURAPIKEY>&rows=3
資料範例如下
{
"searchResults":[
{
"tej_comp_id":34062,
"comp_ban":"43121481",
"comp_name":"宏益纖維工業股份有限公司",
"director_name":"施振榮",
"representative_id":"34062",
"representative_comp_ban":"43121481",
"representative_comp_name":"宏益纖維工業股份有限公司",
"titleName":"董事",
"shareHold":40000000,
"capital":400000000,
"percent":100.0
},
{
"tej_comp_id":646650,
"comp_ban":"80509730",
"comp_name":"智融股份有限公司",
"director_name":"施振榮",
"representative_id":"646650",
"representative_comp_ban":"80509730",
"representative_comp_name":"智融股份有限公司",
"titleName":"董事",
"shareHold":200000,
"capital":2000000,
"percent":100.0
},
{
"tej_comp_id":29352,
"comp_ban":"20828393",
"comp_name":"宏碁股份有限公司",
"director_name":"施振榮",
"representative_id":"29352",
"representative_comp_ban":"20828393",
"representative_comp_name":"宏碁股份有限公司",
"titleName":"董事長",
"shareHold":13458771,
"capital":134587710,
"percent":19.94
}
]
}
[功能]搜尋集團資料
GET https://kyc.tej.com.tw/api/search/group/{keyword}?api_key=<YOURAPIKEY>
針對公司名稱、集團名稱使用關鍵字搜尋,找出近似的結果。以【臺灣水泥】為例
GET https://kyc.tej.com.tw/api/search/group/臺灣水泥?api_key=<YOURAPIKEY>
另可以使用參數rows限定最大回應筆數
GET https://kyc.tej.com.tw/api/search/group/臺灣水泥?api_key=<YOURAPIKEY>&rows=3
資料範例如下
{
"searchResults":[
{
"groupId":"G1101",
"groupName":"台泥集團",
"numberOfCompanies":9,
"numberOfPublicCompanies":7,
"numberOfOverseaCompanies":9
}
]
}
報表API使用方法(report api)
定義
GET https://kyc.tej.com.tw/api/report/{function}/{id}?api_key=<YOURAPIKEY>
第一階段提供以下報表,後續將陸續推出新功能
- 公司資料報表
- 集團資料報表
[功能]公司資料報表
GET https://kyc.tej.com.tw/api/report/company/{id}?api_key=<YOURAPIKEY>
公司ID代號找出公司報表資料,以【臺灣水泥股份有限公司】26914為例
GET https://kyc.tej.com.tw/api/report/company/26914?api_key=<YOURAPIKEY>
公司統一編號找出公司報表資料,以【臺灣水泥股份有限公司】11913502為例
GET https://kyc.tej.com.tw/api/report/company/ban/11913502?api_key=<YOURAPIKEY>
資料範例如下
{
"result":{
"tej_comp_id":26914,
"comp_ban":"11913502",
"comp_id":"1101",
"comp_name":"臺灣水泥股份有限公司",
"comp_add":"臺北市中山區中山北路2段113號",
"comp_status":"核准設立",
"equity_status":"僑外資",
"capital_total":70000000000,
"paid_in_capital":56656192040,
"set_date":"1947-08-23",
"chg_date":"2019-09-02",
"register_organ":"經濟部商業司",
"group":{
"groupId":"G1101",
"groupName":"台泥集團",
"numberOfCompanies":9,
"numberOfPublicCompanies":7,
"numberOfOverseaCompanies":9
},
"directors":[
{
"tej_comp_id":0,
"director_name":"張安平",
"representative_id":"27087",
"representative_comp_ban":"12198203",
"representative_comp_name":"嘉利實業股份有限公司",
"titleName":"董事長",
"shareHold":2699216,
"capital":26992160,
"percent":0.05
},
{
"tej_comp_id":0,
"director_name":"謝其嘉",
"representative_id":"646282",
"representative_comp_ban":"80169887",
"representative_comp_name":"富品投資股份有限公司",
"titleName":"董事",
"shareHold":68957180,
"capital":689571800,
"percent":1.35
},
{
"tej_comp_id":0,
"director_name":"吳東昇",
"representative_id":"26410",
"representative_comp_ban":"07435515",
"representative_comp_name":"新光合成纖維股份有限公司",
"titleName":"董事",
"shareHold":10510119,
"capital":105101190,
"percent":0.21
},
{
"tej_comp_id":0,
"director_name":"王伯元",
"representative_id":"646282",
"representative_comp_ban":"80169887",
"representative_comp_name":"富品投資股份有限公司",
"titleName":"董事",
"shareHold":68957180,
"capital":689571800,
"percent":1.35
},
{
"tej_comp_id":0,
"director_name":"駱錦明",
"representative_id":"25833",
"representative_comp_ban":"04382114",
"representative_comp_name":"國際中橡投資控股股份有限公司",
"titleName":"董事",
"shareHold":94155487,
"capital":941554870,
"percent":1.77
},
{
"tej_comp_id":0,
"director_name":"林南舟",
"representative_id":"645643",
"representative_comp_ban":"70615260",
"representative_comp_name":"十祥投資股份有限公司",
"titleName":"董事",
"shareHold":8537463,
"capital":85374630,
"percent":0.16
},
{
"tej_comp_id":0,
"director_name":"余俊彥",
"representative_id":"30812",
"representative_comp_ban":"22954711",
"representative_comp_name":"中成開發投資股份有限公司",
"titleName":"董事",
"shareHold":25751609,
"capital":257516090,
"percent":0.49
},
{
"tej_comp_id":0,
"director_name":"辜公怡",
"representative_id":"648460",
"representative_comp_ban":"90330707",
"representative_comp_name":"泰和興業股份有限公司",
"titleName":"董事",
"shareHold":5378209,
"capital":53782090,
"percent":0.11
},
{
"tej_comp_id":0,
"director_name":"溫堅",
"representative_id":"646281",
"representative_comp_ban":"80169774",
"representative_comp_name":"恆強投資股份有限公司",
"titleName":"董事",
"shareHold":90991540,
"capital":909915400,
"percent":1.78
},
{
"tej_comp_id":0,
"director_name":"李鐘培",
"titleName":"董事",
"shareHold":2539799,
"capital":25397990,
"percent":0.05
},
{
"tej_comp_id":0,
"director_name":"張啟文",
"representative_id":"640744",
"representative_comp_ban":"23221835",
"representative_comp_name":"信和投資股份有限公司",
"titleName":"董事",
"shareHold":13534729,
"capital":135347290,
"percent":0.25
},
{
"tej_comp_id":0,
"director_name":"陳啟德",
"representative_id":"26902",
"representative_comp_ban":"11892801",
"representative_comp_name":"嘉新水泥股份有限公司",
"titleName":"董事",
"shareHold":193888706,
"capital":1938887060,
"percent":3.8
},
{
"tej_comp_id":0,
"director_name":"劉純穎",
"representative_id":"30875",
"representative_comp_ban":"22959217",
"representative_comp_name":"中信投資股份有限公司",
"titleName":"董事",
"shareHold":137608757,
"capital":1376087570,
"percent":2.69
},
{
"tej_comp_id":0,
"director_name":"蔡志忠",
"representative_id":"646281",
"representative_comp_ban":"80169774",
"representative_comp_name":"恆強投資股份有限公司",
"titleName":"董事",
"shareHold":90991540,
"capital":909915400,
"percent":1.78
},
{
"tej_comp_id":0,
"director_name":"張剛綸",
"representative_id":"26902",
"representative_comp_ban":"11892801",
"representative_comp_name":"嘉新水泥股份有限公司",
"titleName":"董事",
"shareHold":193888706,
"capital":1938887060,
"percent":3.8
},
{
"tej_comp_id":0,
"director_name":"盛治仁",
"titleName":"獨立董事",
"shareHold":0,
"capital":0,
"percent":0.0
},
{
"tej_comp_id":0,
"director_name":"王金山",
"titleName":"獨立董事",
"shareHold":0,
"capital":0,
"percent":0.0
},
{
"tej_comp_id":0,
"director_name":"周玲臺",
"titleName":"獨立董事",
"shareHold":200016,
"capital":2000160,
"percent":0.0
},
{
"tej_comp_id":0,
"director_name":"焦佑鈞",
"titleName":"獨立董事",
"shareHold":0,
"capital":0,
"percent":0.0
}
],
"taxCategories":[
{
"code":"232911",
"name":"陶瓷餐具燒製"
},
{
"code":"233300",
"name":"水泥及混凝土製品製造"
},
{
"code":"620199",
"name":"其他電腦程式設計"
},
{
"code":"382112",
"name":"一般廢棄物處理"
}
],
"indCategories":[
{
"code":"B601010",
"name":"土石採取業",
"english_name":"On land Clay and Stone Quarrying",
"description":"從事土、砂、礫、石之探勘、採取、初步處理及有關準備作業等之行業。包括陸上採土業、陸上採石業、河川砂礫採取業、濱海及海域砂礫採取業、其他土石採取業。,,"
},
{
"code":"C601030",
"name":"紙容器製造業",
"english_name":"Paper Containers Manufacturing",
"description":"從事以紙板、瓦楞紙、浸蠟紙、強力紙等製造密封或通氣之容器或紙袋之行業。,,"
},
{
"code":"C901030",
"name":"水泥製造業",
"english_name":"Cement Manufacturing",
"description":"從事各種水泥或水泥熟料製造之行業。,,"
},
{
"code":"C901040",
"name":"預拌混凝土製造業",
"english_name":"Concrete Mixing Manufacturing",
"description":"從事將水泥、混凝土粒料及摻料(輸氣劑、飛灰、爐碴等),以水充分拌合後供運至工地澆鑄用之行業。,,"
},
{
"code":"C901050",
"name":"水泥及混凝土製品製造業",
"english_name":"Cement and Concrete mixing Manufacturing",
"description":"以水泥、砂、石、水拌合後灌至模具內凝固成型之產品製造之行業。如石綿管、石綿瓦、水泥磚、水泥樑、石綿板、水泥瓦、混凝土管、混凝土磚、水泥浴盆、水泥橋段、水泥垃圾桶、混凝土枕木、水泥空心磚、混凝土邊石、鋼筋水泥製品、預力混凝土管、預力混凝土電杆、加石綿水泥製品、預力混凝土基樁、加纖維水泥製品、混凝土柱、樑、版、預鑄混凝土人孔、手孔、預鑄混凝土隧道弓型支堡、鋼襯預力混凝土自來水管等之製造。,,"
},
{
"code":"C901990",
"name":"其他非金屬礦物製品製造業",
"english_name":"Other Non metallic Mineral Products Manufacturing",
"description":"從事C901010 至C901070 細類以外其他非金屬礦物製品製造之行業,如建築用粘土製品、工業及研磨材料、石灰、石膏製品、雲母製品、石墨製品等。,,"
},
{
"code":"F111090",
"name":"建材批發業",
"english_name":"Wholesale of Building Materials",
"description":"從事建材批發之行業。,,"
},
{
"code":"F211010",
"name":"建材零售業",
"english_name":"Retail Sale of Building Materials",
"description":"從事建材零售之行業。,,"
},
{
"code":"F401010",
"name":"國際貿易業",
"english_name":"International Trade",
"description":"從事一般商品進出口貿易業務。但屬石油輸出、天然氣輸入及許可業務者,係歸入各該細類代碼。,,"
},
{
"code":"G801010",
"name":"倉儲業",
"english_name":"Warehousing and Storage",
"description":"從事經營租賃取酬之堆棧、棚棧、倉庫、保稅倉庫、冷凍冷藏倉庫等行業。,,"
},
{
"code":"H701010",
"name":"住宅及大樓開發租售業",
"english_name":"Residence and Buildings Lease Construction and Development",
"description":"投資開發興建一般住宅、社會住宅、工商大樓之出租出售行業。但不包含經營租賃住宅包租業。,,"
},
{
"code":"H701020",
"name":"工業廠房開發租售業",
"english_name":"Industrial Factory Buildings Lease Construction and Development",
"description":"投資開發興建工業廠房、倉庫之出租出售等行業。,,"
},
{
"code":"H703100",
"name":"不動產租賃業",
"english_name":"Real Estate Rental and Leasing",
"description":"從事老人住宅、租賃住宅包租業以外之不動產之出租業務。如土地、住宅、廠房、倉庫、辦公大樓、攤位、會議室、錄音室或其他不動產之出租。,,"
},
{
"code":"J101040",
"name":"廢棄物處理業",
"english_name":"Waste treatment",
"description":"從事廢棄物處理之行業。,,"
},
{
"code":"ZZ99999",
"name":"除許可業務外,得經營法令非禁止或限制之業務",
"english_name":"\"All business items that are not prohibited or restricted by law",
"description":"except those that are subject to special approval.\",除許可業務外,得經營法令非禁止或限制之業務。,,"
}
],
"extensions":[
{
"extName":"勞動部違反勞動法令事業單位(僱主)資料(最新5筆)",
"extData":[
{
"序號":"1",
"主管機關":"高雄市",
"公告日期":"107/09/10",
"處分日期":"107/07/25",
"處分字號":"高市勞條字第10735743700號",
"事業單位名稱(負責人) / 自然人姓名":"臺灣水泥股份有限公司/張安平",
"違法法規法條":"勞動基準法第32條第2項",
"違反法規內容":"延長工作時間超過法令規定",
"備註說明":""
},
{
"序號":"2",
"主管機關":"職業安全衛生署",
"公告日期":"107/01/26",
"處分日期":"106/10/31",
"處分字號":"勞職授字第1060204558號",
"事業單位名稱(負責人) / 自然人姓名":"臺灣水泥股份有限公司",
"違法法規法條":"職業安全衛生設施規則第258條、第265條暨職業安全衛生法第6條第1項",
"違反法規內容":"從事高壓電源盤檢查、修理作業時,未使作業勞工戴用絕緣用防護具;對於高壓以上之停電作業、活線作業及活線接近作業,未將作業期間、作業內容、作業之電路及接近於此電路之其他電路系統,告知作業之勞工,未指定監督人員負責指揮。",
"備註說明":""
},
{
"序號":"3",
"主管機關":"職業安全衛生署",
"公告日期":"107/01/26",
"處分日期":"106/10/13",
"處分字號":"勞職授字第1060204480號",
"事業單位名稱(負責人) / 自然人姓名":"臺灣水泥股份有限公司",
"違法法規法條":"職業安全衛生設施規則第43條第1項暨職業安全衛生法第6條第1項",
"違反法規內容":"對於輸送帶之傳動鍊條等捲夾有危害勞工之虞之部分,未設置護罩、護圍等設備。",
"備註說明":""
},
{
"序號":"4",
"主管機關":"職業安全衛生署",
"公告日期":"107/01/05",
"處分日期":"106/09/29",
"處分字號":"勞職授字第1060204204號",
"事業單位名稱(負責人) / 自然人姓名":"臺灣水泥股份有限公司",
"違法法規法條":"職業安全衛生設施規則第224條第1項暨職業安全衛生法第6條第1項",
"違反法規內容":"樓梯板鏽蝕截換開口,勞工有遭受墜落危險之虞,未設有適當強度之圍欄防護措施。",
"備註說明":""
},
{
"序號":"5",
"主管機關":"職業安全衛生署",
"公告日期":"107/01/05",
"處分日期":"106/09/29",
"處分字號":"勞職授字第1060204193號",
"事業單位名稱(負責人) / 自然人姓名":"臺灣水泥股份有限公司",
"違法法規法條":"職業安全衛生法第26條第1項",
"違反法規內容":"以其事業之全部或一部分交付承攬時,未於事前告該承攬人有關事業工作環境、危害因素暨本法及有關安全衛生規定應採取之措施。",
"備註說明":""
}
]
}
]
}
}
[功能]集團資料報表
針對集團資料提供整合式報告GET https://kyc.tej.com.tw/api/report/group/{id}?api_key=<YOURAPIKEY>
以【嘉新集團】G1103為例
GET https://kyc.tej.com.tw/api/report/group/G1103?api_key=<YOURAPIKEY>
資料範例如下
{
"result":{
"groupId":"G1103",
"groupName":"嘉新水泥集團",
"numberOfCompanies":53,
"numberOfPublicCompanies":1,
"numberOfOverseaCompanies":31,
"companies":[
{
"tej_comp_id":25869,
"comp_ban":"04401230",
"comp_id":"",
"comp_name":"嘉新國際股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號1樓",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":2948605870,
"paid_in_capital":2948605870,
"set_date":"1973-12-15",
"chg_date":"2017-06-21",
"register_organ":"經濟部商業司"
},
{
"tej_comp_id":25903,
"comp_ban":"04422501",
"comp_id":"",
"comp_name":"佐佑投資股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"僑外資",
"capital_total":300000000,
"paid_in_capital":300000000,
"set_date":"1974-02-12",
"chg_date":"2017-06-01",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":26902,
"comp_ban":"11892801",
"comp_id":"1103",
"comp_name":"嘉新水泥股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":7796390500,
"paid_in_capital":7747805480,
"set_date":"1954-12-13",
"chg_date":"2019-07-18",
"register_organ":"經濟部商業司"
},
{
"tej_comp_id":636601,
"comp_ban":"11836034",
"comp_id":"",
"comp_name":"嘉運貿易股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":10000000,
"paid_in_capital":500000,
"set_date":"1972-02-04",
"chg_date":"2013-11-27",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":3108257,
"comp_ban":"12176361",
"comp_id":"",
"comp_name":"偉戎企業股份有限公司",
"comp_add":"臺北市中山區松江路206號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":2000000,
"paid_in_capital":2000000,
"set_date":null,
"chg_date":"1980-01-16",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":3108326,
"comp_ban":"12178109",
"comp_id":"",
"comp_name":"嘉安電子股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":24000000,
"paid_in_capital":12000000,
"set_date":"1978-06-09",
"chg_date":null,
"register_organ":"臺北市政府"
},
{
"tej_comp_id":27062,
"comp_ban":"12178993",
"comp_id":"",
"comp_name":"嘉泥建設開發股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號11樓",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":800000000,
"paid_in_capital":717103530,
"set_date":"1978-06-28",
"chg_date":"2019-06-04",
"register_organ":"經濟部商業司"
},
{
"tej_comp_id":27087,
"comp_ban":"12198203",
"comp_id":"",
"comp_name":"嘉利實業股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號11樓",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":1423272500,
"paid_in_capital":927927000,
"set_date":"1978-10-23",
"chg_date":"2019-08-08",
"register_organ":"經濟部商業司"
},
{
"tej_comp_id":27243,
"comp_ban":"12326930",
"comp_id":"",
"comp_name":"松佐投資股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號2樓",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":248000000,
"paid_in_capital":248000000,
"set_date":"1981-05-02",
"chg_date":"2019-07-09",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":28987,
"comp_ban":"16773305",
"comp_id":"",
"comp_name":"嘉環東泥股份有限公司",
"comp_add":"高雄市前金區五福三路21號5樓之1",
"comp_status":"解散",
"equity_status":"",
"capital_total":1139402700,
"paid_in_capital":686368810,
"set_date":"1998-12-21",
"chg_date":"2019-06-14",
"register_organ":"經濟部商業司"
},
{
"tej_comp_id":31505,
"comp_ban":"23465944",
"comp_id":"",
"comp_name":"士新儲運股份有限公司",
"comp_add":"高雄市左營區裕誠路423號5樓",
"comp_status":"解散",
"equity_status":"",
"capital_total":1743000000,
"paid_in_capital":933485000,
"set_date":"1989-10-23",
"chg_date":"2019-03-21",
"register_organ":"經濟部商業司"
},
{
"tej_comp_id":32868,
"comp_ban":"28212928",
"comp_id":"",
"comp_name":"嘉北國際股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":195600000,
"paid_in_capital":195600000,
"set_date":"2006-08-18",
"chg_date":"2018-06-15",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":636660,
"comp_ban":"12194136",
"comp_id":"",
"comp_name":"雲風股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號2樓",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":16500000,
"paid_in_capital":16500000,
"set_date":"1978-09-22",
"chg_date":"2019-07-02",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":640526,
"comp_ban":"22954304",
"comp_id":"",
"comp_name":"龍泉投資股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號11樓",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":114000000,
"paid_in_capital":114000000,
"set_date":"1988-05-25",
"chg_date":"2019-07-03",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":36635,
"comp_ban":"80035092",
"comp_id":"",
"comp_name":"嘉新資產管理開發股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":1000000000,
"paid_in_capital":1000000000,
"set_date":"2003-12-15",
"chg_date":"2019-08-05",
"register_organ":"經濟部商業司"
},
{
"tej_comp_id":37180,
"comp_ban":"84115842",
"comp_id":"",
"comp_name":"台灣鴻新船業股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號9樓901室",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":650000000,
"paid_in_capital":20000000,
"set_date":"1992-12-30",
"chg_date":"2018-11-12",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":364161,
"comp_ban":"42825574",
"comp_id":"",
"comp_name":"嘉和健康生活股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":400000000,
"paid_in_capital":300000000,
"set_date":"2015-11-23",
"chg_date":"2019-03-13",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":388613,
"comp_ban":"33282698",
"comp_id":"",
"comp_name":"順隆窯業股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號1樓",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":96600000,
"paid_in_capital":96600000,
"set_date":"1969-01-10",
"chg_date":"2018-12-26",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":389926,
"comp_ban":"53912863",
"comp_id":"",
"comp_name":"藍鈞股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":83000000,
"paid_in_capital":83000000,
"set_date":"2012-07-11",
"chg_date":"2017-06-30",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":390329,
"comp_ban":"54188972",
"comp_id":"",
"comp_name":"嘉昇建設股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":250000000,
"paid_in_capital":250000000,
"set_date":"2013-05-06",
"chg_date":"2019-06-04",
"register_organ":"臺北市政府"
},
{
"tej_comp_id":390536,
"comp_ban":"54685492",
"comp_id":"",
"comp_name":"雲嘉國際股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":1600000000,
"paid_in_capital":1580000000,
"set_date":"2014-03-24",
"chg_date":"2019-04-08",
"register_organ":"經濟部商業司"
},
{
"tej_comp_id":3808214,
"comp_ban":"42638220",
"comp_id":"",
"comp_name":"榮安股份有限公司",
"comp_add":"臺北市中山區中山北路2段96號9樓",
"comp_status":"核准設立",
"equity_status":"",
"capital_total":15000000,
"paid_in_capital":15000000,
"set_date":"2015-09-03",
"chg_date":"2018-11-13",
"register_organ":"臺北市政府"
}
],
"relations":[
{
"od":1,
"name":"辜成允",
"relation":"張永平(姻親),張如平(姻親),張安平(妹夫),張剛綸(姻親),張意平(姻親),辜啟允(兄弟)"
},
{
"od":2,
"name":"辜啟允",
"relation":"張永平(姻親),張安平(舅子),辜成允(手足)"
},
{
"od":3,
"name":"王立心",
"relation":"王建國(父女),張永平(舅甥),張如平(姨甥),張安平(舅甥),張剛綸(表兄妹),張意平(母女)"
},
{
"od":4,
"name":"王建國",
"relation":"王立心(父女),張永平(舅子),張安平(舅子),張剛綸(外甥),張意平(配偶)"
},
{
"od":5,
"name":"張永平",
"relation":"王立心(外甥女),王建國(妹夫),張如平(手足),張安平(兄弟),張剛綸(父子),張意平(姊弟),辜成允(姻親),辜啟允(姻親)"
},
{
"od":6,
"name":"張意平",
"relation":"王立心(母女),王建國(配偶),張永平(姊弟),張如平(姊妹),張安平(姊弟),辜成允(姻親)"
},
{
"od":7,
"name":"張安平",
"relation":"王立心(外甥女),王建國(姐夫),張永平(兄弟),張如平(手足),張剛綸(叔侄),張意平(姊弟),辜成允(舅子),辜啟允(舅子)"
},
{
"od":8,
"name":"張如平",
"relation":"王立心(外甥女),王建國(妹夫),張永平(手足),張安平(手足),張意平(姊妹),辜成允(姻親)"
},
{
"od":9,
"name":"張剛綸",
"relation":"王立心(表兄妹),王建國(姑丈),張永平(父子),張安平(叔侄),張意平(姑侄),辜成允(姻親)"
}
]
}
}
資料API使用方法(datatables api)
定義
GET https://kyc.tej.com.tw/api/datatables/{datatable_code}/{table_code}.{format}?<row_filter_criteria>
以公司資料(TWN/MOEA_COMPANY)為例,您可以使用下列方式取得資料
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.json?api_key=<YOURAPIKEY>
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.xml?api_key=<YOURAPIKEY>
{
"datatable":{
"data":[
[
33702,
"35012903",
"1",
"大西洋飲料股份有限公司",
"",
"",
"核准設立",
"",
566226270,
566226270,
"新北市三重區幸福里30鄰重陽路3段99號10樓",
"經濟部商業司",
"1965-07-24",
"2019-05-24",
null,
null,
"",
"",
"",
"",
null,
"",
null,
null,
null,
"",
null,
null
]
],
"columns":[
{
"name":"tej_comp_id",
"type":"decimal(8,0)",
"description":"TEJ公司碼",
"unit":"-"
},
{
"name":"comp_ban",
"type":"varchar(8)",
"description":"統一編號",
"unit":"-"
},
{
"name":"regtp",
"type":"char(1)",
"description":"登記類型",
"unit":"-"
},
{
"name":"comp_name",
"type":"nchar",
"description":"公司名稱",
"unit":"-"
},
{
"name":"foreign_name",
"type":"nchar",
"description":"外文公司名稱",
"unit":"-"
},
{
"name":"importer_name_eng",
"type":"nchar",
"description":"出進口英文名稱",
"unit":"-"
},
{
"name":"comp_status",
"type":"varchar(20)",
"description":"公司現況",
"unit":"-"
},
{
"name":"equity_status",
"type":"varchar(20)",
"description":"股權狀況",
"unit":"-"
},
{
"name":"capital_total",
"type":"decimal(20,0)",
"description":"資本總額",
"unit":"-"
},
{
"name":"paid_in_capital",
"type":"decimal(20,0)",
"description":"實收資本額",
"unit":"-"
},
{
"name":"comp_add",
"type":"nchar",
"description":"公司所在地",
"unit":"-"
},
{
"name":"register_organ",
"type":"nchar",
"description":"登記機關",
"unit":"-"
},
{
"name":"set_date",
"type":"date",
"description":"核准設立日期",
"unit":"-"
},
{
"name":"chg_date",
"type":"date",
"description":"最後核准變更日期",
"unit":"-"
},
{
"name":"closed_date_beg",
"type":"date",
"description":"停業起日",
"unit":"-"
},
{
"name":"closed_date_end",
"type":"date",
"description":"停業迄日",
"unit":"-"
},
{
"name":"closed_organ",
"type":"nchar",
"description":"停業機關",
"unit":"-"
},
{
"name":"specialstock_rights",
"type":"nchar",
"description":"複數表決權特別股",
"unit":"-"
},
{
"name":"specialstock_veto",
"type":"nchar",
"description":"特定事項具否決權特別股",
"unit":"-"
},
{
"name":"restrictedquota_rights",
"type":"nchar",
"description":"限制名額權利",
"unit":"-"
},
{
"name":"domestic_capital",
"type":"decimal(20,0)",
"description":"境內營運資金",
"unit":"-"
},
{
"name":"organization",
"type":"nchar",
"description":"組織類型",
"unit":"-"
},
{
"name":"set_num",
"type":"decimal(10,0)",
"description":"核准設立編號",
"unit":"-"
},
{
"name":"duration_date_beg",
"type":"date",
"description":"存續起日",
"unit":"-"
},
{
"name":"duration_date_end",
"type":"date",
"description":"存續迄日",
"unit":"-"
},
{
"name":"cause_dissolution",
"type":"nchar",
"description":"約定解散事由",
"unit":"-"
},
{
"name":"chg_num",
"type":"decimal(10,0)",
"description":"最後核准編號",
"unit":"-"
},
{
"name":"tej_bst_id",
"type":"decimal(8,0)",
"description":"負責人/代表人_TEJ董監碼",
"unit":"-"
}
]
},
"meta":{
"next_cursor_id":null
}
}
<?xml version="1.0" encoding="UTF-8"?>
<tej-response>
<datatable>
<data type="array">
<datum type="array">
<datum type="float">33702</datum>
<datum>35012903</datum>
<datum>1</datum>
<datum>大西洋飲料股份有限公司</datum>
<datum />
<datum />
<datum>核准設立</datum>
<datum />
<datum type="float">566226270</datum>
<datum type="float">566226270</datum>
<datum>新北市三重區幸福裡30鄰重陽路3段99號10樓</datum>
<datum>經濟部商業司</datum>
<datum type="date">1965-07-24</datum>
<datum type="date">2019-05-24</datum>
<datum nil="true" />
<datum nil="true" />
<datum />
<datum />
<datum />
<datum />
<datum nil="true" />
<datum />
<datum nil="true" />
<datum nil="true" />
<datum nil="true" />
<datum />
<datum nil="true" />
<datum nil="true" />
</datum>
</data>
<columns type="array">
<column>
<description>TEJ公司碼</description>
<name>tej_comp_id</name>
<type>decimal(8,0)</type>
<unit>-</unit>
</column>
<column>
<description>統一編號</description>
<name>comp_ban</name>
<type>varchar(8)</type>
<unit>-</unit>
</column>
<column>
<description>登記類型</description>
<name>regtp</name>
<type>char(1)</type>
<unit>-</unit>
</column>
<column>
<description>公司名稱</description>
<name>comp_name</name>
<type>nchar(200)</type>
<unit>-</unit>
</column>
<column>
<description>外文公司名稱</description>
<name>foreign_name</name>
<type>nchar(200)</type>
<unit>-</unit>
</column>
<column>
<description>出進口英文名稱</description>
<name>importer_name_eng</name>
<type>nchar(200)</type>
<unit>-</unit>
</column>
<column>
<description>公司現況</description>
<name>comp_status</name>
<type>varchar(20)</type>
<unit>-</unit>
</column>
<column>
<description>股權狀況</description>
<name>equity_status</name>
<type>varchar(20)</type>
<unit>-</unit>
</column>
<column>
<description>資本總額</description>
<name>capital_total</name>
<type>decimal(20,0)</type>
<unit>-</unit>
</column>
<column>
<description>實收資本額</description>
<name>paid_in_capital</name>
<type>decimal(20,0)</type>
<unit>-</unit>
</column>
<column>
<description>公司所在地</description>
<name>comp_add</name>
<type>nchar(200)</type>
<unit>-</unit>
</column>
<column>
<description>登記機關</description>
<name>register_organ</name>
<type>nchar(100)</type>
<unit>-</unit>
</column>
<column>
<description>核准設立日期</description>
<name>set_date</name>
<type>date</type>
<unit>-</unit>
</column>
<column>
<description>最後核准變更日期</description>
<name>chg_date</name>
<type>date</type>
<unit>-</unit>
</column>
<column>
<description>停業起日</description>
<name>closed_date_beg</name>
<type>date</type>
<unit>-</unit>
</column>
<column>
<description>停業迄日</description>
<name>closed_date_end</name>
<type>date</type>
<unit>-</unit>
</column>
<column>
<description>停業機關</description>
<name>closed_organ</name>
<type>nchar(50)</type>
<unit>-</unit>
</column>
<column>
<description>複數表決權特別股</description>
<name>specialstock_rights</name>
<type>nchar(50)</type>
<unit>-</unit>
</column>
<column>
<description>特定事項具否決權特別股</description>
<name>specialstock_veto</name>
<type>nchar(50)</type>
<unit>-</unit>
</column>
<column>
<description>限制名額權利</description>
<name>restrictedquota_rights</name>
<type>nchar(50)</type>
<unit>-</unit>
</column>
<column>
<description>境內營運資金</description>
<name>domestic_capital</name>
<type>decimal(20,0)</type>
<unit>-</unit>
</column>
<column>
<description>組織類型</description>
<name>organization</name>
<type>nchar(20)</type>
<unit>-</unit>
</column>
<column>
<description>核准設立編號</description>
<name>set_num</name>
<type>decimal(10,0)</type>
<unit>-</unit>
</column>
<column>
<description>存續起日</description>
<name>duration_date_beg</name>
<type>date</type>
<unit>-</unit>
</column>
<column>
<description>存續迄日</description>
<name>duration_date_end</name>
<type>date</type>
<unit>-</unit>
</column>
<column>
<description>約定解散事由</description>
<name>cause_dissolution</name>
<type>nchar(200)</type>
<unit>-</unit>
</column>
<column>
<description>最後核准編號</description>
<name>chg_num</name>
<type>decimal(10,0)</type>
<unit>-</unit>
</column>
<column>
<description>負責人/代表人_TEJ董監碼</description>
<name>tej_bst_id</name>
<type>decimal(8,0)</type>
<unit>-</unit>
</column>
</columns>
</datatable>
<meta />
</tej-response>
提示:
取得的資料是未排序資料,如須排序請取得後自行排序,或指定 opts.sort參數。
資料篩選
如果需要針對欄位篩選,例如僅須取得大西洋飲料股份有限公司(35012903),請直接增加欄位篩選條件 comp_ban=35012903
或是同時取得兩個公司資料Y9999及Y9998,請利用序列條件 comp_ban=35012903,23740225
單次取得資料限制最多10,000筆,您可以擷取 next_cursor_id的資訊,並用opts.cursor_id參數來取得下一頁的資料
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.json?comp_ban=35012903&api_key=<YOURAPIKEY>
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.xml?comp_ban=35012903&api_key=<YOURAPIKEY>
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.json?comp_ban=35012903,23740225&api_key=<YOURAPIKEY>
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.xml?comp_ban=35012903,23740225&api_key=<YOURAPIKEY>
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.json?&opts.cursor_id=IsudN6LrIw&api_key=<YOURAPIKEY>
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.xml?&opts.cursor_id=IsudN6LrIw&api_key=<YOURAPIKEY>
欄位篩選
若僅需要取得單一欄位,請利用特殊參數 opts中的columns條件,例如僅須取得公司名稱(comp_name)
若僅需要取得多個欄位,請利用特殊參數 opts中的columns條件,例如須取得統一編號(comp_ban)及公司名稱(comp_name)
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.json?opts.columns=comp_name&api_key=<YOURAPIKEY>
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.xml?opts.columns=comp_name&api_key=<YOURAPIKEY>
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.json?opts.columns=comp_ban,comp_name&api_key=<YOURAPIKEY>
GET https://kyc.tej.com.tw/api/datatables/TWN/MOEA_COMPANY.json?opts.columns=comp_ban,comp_name&api_key=<YOURAPIKEY>
資料篩選運算
查詢參數
日期格式
資料輸出的日期格式一率採用yyyy-MM-ddTHH:mm:ssZ,例如2018-05-09T10:20:30Z。
篩選條件中的日期格式,可支援的格式如下表,其中Z代表時區,例如台灣為+08:00,但可以省略。