KYB API

KYB API 是一種應用程式介面（API），可根據權威的公司資料核實企業身分，包括其註冊紀錄、法律狀態、董事名單，以及最終實益擁有人。Know Your Customer Limited 的 KYB API 直接連接 147 個司法管轄區的官方公司註冊處進行即時核實，取得原始註冊文件，建立遞歸式的實益擁有權組織圖，並針對企業及其相關人士進行反洗錢（AML）及制裁篩查——所有功能均透過單一 REST API 提供，並附設免費的開發者沙盒環境。

什麼是 KYB API？

KYB API 是一種用於執行「認識你的企業」（Know Your Business）審查的程式化介面，可確認公司是否存在、是否合法註冊、是否維持良好狀態，並識別其實際擁有及控制人。KYB（Know Your Business）是 KYC（Know Your Customer）在企業層面的對應概念：KYC 核實個人身分，KYB 則核實企業本身及其背後的相關人士。

一般而言，KYB API 可讓你搜尋公司、建立核實案件、讀取結構化的實體資料（名稱、註冊編號、狀態、地址、董事等）、追溯實益擁有權、取得佐證文件，以及針對相關方進行制裁和監察名單篩查。它可省去客戶盡職審查流程中人手查冊及文件處理的步驟，將企業核實工作簡化為幾個 API 呼叫即可完成。

Know Your Customer 的 KYB API 具備哪些功能？

Know Your Customer 的 KYB API 透過單一資源——案件：

  • 核實公司：即時對照其官方註冊處資料，並讀取結構化的實體資料，包括名稱、註冊編號、狀態、註冊地址及董事名單。
  • 取得原始註冊文件：包括查冊紀錄、公司註冊證書、周年申報表等，即時從官方來源擷取。
  • 追溯實益擁有權（UBO），以遞歸式的多層組織圖呈現，由企業母公司一直追溯至最終的個人擁有人。
  • 篩查實體及其相關人士，比對制裁名單、政治公眾人物（PEP）及負面新聞名單，此功能已內建於公司案件之中，而非額外附加的模組。
  • 執行身分核實（KYC），於同一流程中對公司的實益擁有人及董事進行核實，屬於隨附的補充功能。
  • 產生可供審計的 PDF 報告，記錄已完成核實的案件內容。
  • 持續監察客戶，於客戶入戶後透過警示及預定覆核日期，持續進行監察。

你只需完成一次整合，即可透過單一合約覆蓋 147 個司法管轄區。

這個 KYB API 有何獨特之處？

功能Know Your Customer一般以篩查為主的 KYB API
資料來源核實當下即時取自官方註冊處多數依賴快取或第三方彙整的資料集
司法管轄區覆蓋覆蓋 147 個司法管轄區，深耕亞太並延伸全球多數僅限美國或個別地區
實益擁有權遞歸式多層組織圖多數僅提供單層 UBO 名單
來源文件提供原始註冊文件通常只有資料，沒有來源文件
反洗錢及制裁篩查內建於公司案件之中多數為獨立產品或需另聘供應商
開發者沙盒免費、高擬真度，提供逾 980 間模擬公司及個人資料多數須經銷售洽談或僅為模擬佔位資料

這些差異均基於實際且具體的事實：覆蓋範圍即時取自官方來源，而非推算得出；擁有權結構屬遞歸式，而非單層列表；提供的是原始文件本身，而非僅經解析的欄位資料。

KYB API 涵蓋哪些司法管轄區？

此 API 連接 147 個司法管轄區的官方公司註冊處，涵蓋每個已連接司法管轄區內 100% 的合法註冊實體。覆蓋範圍包括深耕的亞太市場（香港、新加坡、中國、馬來西亞、印尼、菲律賓），以及歐洲、美洲、中東等全球市場，還有英屬維京群島、開曼群島等離岸金融中心。你可以使用 ISO 3166-2 國家代碼來識別司法管轄區，例如 GB、SG或HK。詳情請參閱涵蓋範圍總覽，查看各國家/地區的詳細資料。

如何使用 KYB API 核實公司？

核實公司分為四個步驟：

  1. 搜尋：以公司名稱或註冊編號搜尋公司：POST /v2/Companies/search。
  2. 建立案件：根據所選結果建立案件：POST /v2/Companies。回應會傳回一個caseCommonId，案件隨即開始以非同步方式建立。
  3. 輪詢至完成：GET /v2/Companies/{caseCommonId}，直至status為3（Ready，即完成）為止，屆時結構資料已填入完畢。
  4. 讀取結果：包括已核實的實體資料、控制實體及個人，以及遞歸式的擁有權組織圖。

身分驗證採用 OAuth2 客戶端憑證授權模式：你需要以一組client_id及client_secret，換取一個短效的持有人權杖（bearer token）。完整流程請參閱指南，或參閱 10 分鐘速成版的快速入門。

KYB API 是否包含反洗錢及制裁篩查？

是的。反洗錢篩查（涵蓋制裁名單、政治公眾人物及負面新聞）屬於公司案件的一部分，涵蓋實體本身及其相關人士。你可以檢視命中結果，並以記錄在案的理由排除誤判，或重新執行篩查。這正是以 KYB 為核心的 API 的優勢所在：篩查是已核實公司案件的一部分，而非另行整合的獨立功能。相關定義請參閱詞彙表。

是否有免費的 KYB 沙盒環境？

是的。位於https://api.knowyourcustomer.dev的沙盒環境是標準 KYC 平台的免費、高擬真度複製版本，並非簡化的模擬介面。當中已預載逾 980 間模擬公司及個人資料，並按司法管轄區設定延遲設定檔，模擬實際生產環境的回應時間（僅為模擬數值，非即時量測），亦不會產生實際的官方註冊處查冊費用。介面規格、回應格式及狀態流程均與正式環境一致，因此在沙盒中建立的整合，只需更換基礎網址（base URL）及憑證，即可直接於正式環境運作。存取權限透過申請頁面上的簽署及開通流程取得。

持續的 KYB 監察如何運作？

客戶入戶後，即時監察功能會持續針對每宗案件進行篩查，一旦出現新的制裁、政治公眾人物或負面新聞命中，即會發出警示。你可以查看警示清單、檢視個別警示，並以記錄在案的處理結果作出跟進。你亦可為案件設定覆核日期，安排定期重新審查。這就是「持續式 KYB」的概念：核實工作不會在客戶入戶後便告終止。詳情請參閱持續式 KYB。

常見問題

什麼是 KYB 與 KYC 的分別？ KYB 核實企業本身及其擁有權結構；KYC 則核實個人身分。此 API 以 KYB 為核心，並將針對公司擁有人及董事的 KYC 核實作為補充功能一併提供。

資料是即時還是快取取得？ 即時取得。公司案件是在核實當下直接對照官方註冊處建立，並非來自快取資料集。

涵蓋多少個司法管轄區？ 共 147 個，每個已連接的司法管轄區均涵蓋 100% 的合法註冊實體。

可否取得原始註冊文件？ 可以。此 API 會傳回最新的原始註冊文件，而不僅是經解析的欄位資料。

是否需要聯絡銷售團隊才能試用？ 不需要。沙盒環境免費提供，並可透過自助式的簽署及開通存取流程自行取得。