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
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>
或是同時取得兩個公司資料Y9999及Y9998,請利用序列條件 comp_ban=35012903,23740225
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>
單次取得資料限制最多10,000筆,您可以擷取 next_cursor_id的資訊,並用opts.cursor_id參數來取得下一頁的資料
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)
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>
若僅需要取得多個欄位,請利用特殊參數 opts中的columns條件,例如須取得統一編號(comp_ban)及公司名稱(comp_name)
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>

資料篩選運算

篩選運算
是否必要
詳細說明
使用範例
=
指定欄位等於指定的文字或數值
comp_ban=35012903
.gt=
指定欄位大於指定的數值
capital_total.gt=0
.lt=
指定欄位小於指定的數值
capital_total.lt=0
.gte=
指定欄位大於或等於指定的數值
capital_total.gte=0
.lte=
指定欄位小於或等於指定的數值
capital_total.lte=0
.ne=
指定欄位不等於指定的數值
capital_total.ne=0

查詢參數

參數
是否必要
詳細說明
使用範例
opts.columns
指定需要取得的欄位,欄位名稱用逗號隔開
opts.columns=comp_ban,comp_name,capital_total
opts.per_page
指定每次取得的資料數量(上限為10,000),可利用opts.cursor_id分次取得資料,但總筆數不得超過1,000,000筆
opts.per_page=100
opts.cursor_id
每次呼叫若還有後續資料,API則產生cursor_id,取用這個id作下一次的呼叫,可取得剩餘或下一頁的資料。
opts.cursor_id=LK8whTtt8w
opts.sort
指定排序的欄位及排序方式,採用 [欄位名稱].[排序方式]表示,排序方式有正向排序(asc)及反向排序(desc),預設為正向排序。
opts.sort=chg_date.desc
opts.pivot
轉置表格功能,可讓資料變成欄位。目前僅支援財務相關表格
opts.pivot=true

日期格式

資料輸出的日期格式一率採用yyyy-MM-ddTHH:mm:ssZ,例如2018-05-09T10:20:30Z。

篩選條件中的日期格式,可支援的格式如下表,其中Z代表時區,例如台灣為+08:00,但可以省略。

支援格式
使用範例
yyyy-MM-ddTHH:mm:ss.SSSZ
2018-05-09T10:20:30.000Z
yyyy-MM-ddHH:mm:ss.SSSZ
2018-05-0910:20:30.000Z
yyyyMMddTHHmmss.SSSZ
20180509T102030.000Z
yyyy-MM-ddTHH:mm:ssZ
2018-05-09T10:20:30Z
yyyy-MM-dd HH:mm:ssZ
2018-05-09 10:20:30Z
yyyy-MM-ddHH:mm:ssZ
2018-05-0910:20:30Z
yyyyMMddTHHmmssZ
20180509T102030Z
yyyyMMddTHHmmssZ
20180509T102030Z
yyyy-MM-dd
2018-05-09
yyyy/MM/dd
2018/05/09
yyyyMMdd
20180509