经核验的数据，直达您的系统。

面向公司登记、土地记录、个人 KYC 核查及政府数字身份的 REST API。结果以结构化 JSON 连同来源文件返回，通过 webhook 或轮询送达。

文档
docs.fill-easy.com
  • 公司、土地、KYC 及电子身份 API
  • Webhook 或轮询
  • 智能体 API 即将推出
阅读 API 文档联系销售团队
onboarding-service → Fill Easy API
POST /cra/request
x-client-id: ••••••••
{
  "countryCode": "HK",
  "companyId": "3182045",
  "callbackUrl": "https://onboarding.bank.example/hooks/fe"
}
200 OK · 已签发令牌，报告随后通过 webhook 送达
{ "token": "tok_9f1c…" }

→ POST https://onboarding.bank.example/hooks/fe
{
  "event": "cra.report.completed",
  "data": {
    "companyIdentification": { "companyName": { "english": "Silverkite Trading Limited" } },
    "registrationDetails": { "status": { "english": "Live" } },
    "originalDocuments": [ { "fileName": "…pdf", "url": "https://…" } ]
  }
}
  • 报告已保存至申请 APP-20931
  • 已附登记机关文件
接口及字段取自 docs.fill-easy.com。数值均为虚构。

所有 API，集中一处。

公司及物业记录、个人 KYC 核查及政府数字身份，均使用同一套凭证。展开卡片即可查看其接口。

公司及物业

CorpVerify

Webhook 或轮询

覆盖 60+ 个司法管辖区的公司登记数据及文件：按名称搜索、基本信息、存档文件、诉讼记录，以及附登记机关原始文件的完整报告。

8 个端点
  • POST/cra/{countryCode}/search/companies按名称搜索公司
  • POST/cra/{countryCode}/search/company公司基本信息
  • POST/cra/{countryCode}/search/documents公司存档文件
  • POST/cra/{countryCode}/search/ird香港税务局商业登记册查询
  • POST/cra/{countryCode}/search/litigation诉讼记录
  • POST/cra/request申请报告或文件
  • POST/cra/poll轮询报告
  • GET/cra/info国家/地区及文件类型
文档

土地注册处报告

Webhook 或轮询

按地址查询香港土地注册处记录，并获取官方土地文件。

3 个端点
  • POST/lra/search查询地址记录
  • POST/lra/request申请土地报告
  • POST/lra/poll轮询报告
文档

个人 KYC

KYC China

Webhook 或轮询

针对内地居民的身份、人脸比对、银行卡、手机号、欺诈黑名单、诉讼及犯罪记录核查。一次请求即可运行您的输入所允许的全部核查，或仅运行您指定的产品。

2 个端点
  • POST/kyc/cn/request运行核查
  • POST/kyc/cn/poll轮询结果
文档

KYC Hong Kong

多数在同一调用中返回

反洗钱、制裁及政治公众人物筛查；查询证监会、积金局及保险业监管局的持牌人登记册，并附登记册条目的页面打印件；以及香港公司注册处董事索引。

6 个端点
  • POST/kyc/hk/screening反洗钱、制裁及政治公众人物筛查
  • POST/kyc/hk/sfc证监会持牌人查询
  • POST/kyc/hk/mpfa积金局中介人查询
  • POST/kyc/hk/ia保险业监管局保险中介人查询
  • POST/kyc/hk/director公司注册处董事索引查询
  • POST/kyc/hk/director/poll轮询董事索引查询结果
文档

KYC Licensee

Webhook 或轮询

一次请求即可筛查一名保险中介人候选人：保险业监管局、证监会及积金局登记册、法院记录、反洗钱筛查；如提供内地身份证件，还包括内地背景核查。返回一份综合结果。

2 个端点
  • POST/kyc/licensee开始筛查
  • POST/kyc/licensee/poll轮询结果
文档

Facial & ID Scan

Webhook、轮询或直接调用

证件核验、人脸比对及静默活体检测，可在 Fill Easy 托管页面上完成，也可直接从您自己的应用调用。

3 个端点
  • POST/ocr/auth启动托管会话
  • POST/ocr/poll轮询结果
  • POST/ocr/verify直接核验图像
文档

数字身份

iAM Smart

用户授权后轮询

香港的电子身份“智方便”：登录、以用户授权的个人资料填写表格、哈希及 PDF 签署，包括无需事先登录的匿名流程。

9 个端点
  • POST/iamsmart/v2/request/auth身份认证
  • POST/iamsmart/v2/request/formfilling表格填写
  • POST/iamsmart/v2/request/signing签署
  • POST/iamsmart/v2/request/pdf-signingPDF 签署
  • POST/iamsmart/v2/request/reauth重新认证
  • POST/iamsmart/v2/request/formfilling-anonymous匿名表格填写
  • POST/iamsmart/v2/request/signing-anonymous匿名哈希签署
  • POST/iamsmart/v2/request/pdf-signing-anonymous匿名 PDF 签署
  • POST/iamsmart/v2/callback/client轮询数据
文档

Singpass

用户授权后轮询

新加坡的电子身份：核验个人身份，并在获得授权后获取 MyInfo 及 MyInfo Business 数据。

4 个端点
  • POST/sgid/request/qr核验
  • POST/sgid/request/authMyInfo
  • POST/sgid/request/auth-bizMyInfo Business
  • POST/sgid/callback/client轮询数据
文档

Sino Connect

SDK 读取后轮询

网络身份认证 China eID：通过 Fill Easy SDK 以 NFC 读取居民身份证，并将实时人脸与证件照片比对。

3 个端点
  • POST/sino-connect/nfc/callbackNFC 轮询
  • POST/sino-connect/face-rec/request人脸识别请求
  • POST/sino-connect/face-rec/callback人脸识别轮询
文档

UAE Pass

用户授权后轮询

阿联酋国家数字身份：认证个人身份，并请求出示文件。

4 个端点
  • POST/uaepass/request/auth身份认证
  • POST/uaepass/request/presentation请求出示文件
  • POST/uaepass/poll轮询数据
  • POST/uaepass/logout退出登录
文档

账户

账单

在同一调用中返回

指定时间范围内计入您账户的计费项目，便于与您自己的记录对账。

1 个端点
  • GET/core/billing指定时间范围内的计费项目
文档

数据直达决策发生之处。

您的系统在需要证据的那一刻调用 API，结果直接回传给系统。无需任何人重新录入登记机关摘录，也无需四处追讨 PDF。

调用方

  • 客户准入流程企业提交申请；审批前运行公司报告
  • 案件管理分析师开立案件；附上 KYC 结果
  • 定期复核定时任务对到期复核的个人和实体重新筛查
  • 数据平台结构化字段输入您的数据仓库及风险模型
事件日志 · onboarding-service
申请 APP-20931
  1. 您的系统POST /cra/request，附 callbackUrl
  2. API200 OK，令牌 tok_9f1c…
  3. APIwebhook cra.report.completed
  4. 您的系统将报告字段保存至申请记录
  5. 您的系统附上登记机关原始文件
  • Webhook，并以轮询作为备用
  • 登记机关原始文件
  • 使用 dryRun 测试，不产生费用
接口及字段取自 docs.fill-easy.com。数值均为虚构。

数据来源

  • 公司登记机关60+ 个司法管辖区，附原始文件
  • 香港土地注册处地址查询及土地文件
  • KYC 数据源观察名单、香港持牌人登记册、内地政府、运营商及银行记录
  • 政府数字身份“智方便”iAM Smart、Singpass、China eID、UAE Pass

您的系统保存的内容

  • 结构化字段

    注册详情、管理层、所有权及股本，可直接存储和比对。

  • 原始文件

    登记机关自身的文件，在报告中附链接，供审查人员和审计师查阅。

  • 报告元数据

    报告日期、国家/地区，以及每份所请求文件的状态。

  • 请求轨迹

    每次调用都有令牌和请求编号；如您提供，还包括您自己的参考编号。

各团队如何接入。

五个集成案例，分别使用五种不同的 API：背景、调用、返回内容，以及日常如何运行。

背景小企业在银行应用中开户。申请送达审查人员之前，客户准入服务需要取得该公司的登记机关报告。

POST/cra/request
{
  "countryCode": "HK",
  "companyId": "3182045",
  "externalRefId": "APP-20931",
  "callbackUrl": "https://onboarding.bank.example/hooks/fe"
}

返回内容

即时返回
令牌，如错过 webhook 可用于轮询
Webhook
cra.report.completed
报告
注册详情、管理层、所有权、股本
文件
登记机关原始文件，附链接
时效
香港公司并提供公司编号时自动获取；通常 5 分钟内

运行方式

  1. 客户在应用中输入企业名称。
  2. /cra/HK/search/companies 返回匹配的公司及其编号。
  3. 服务调用 /cra/request 并附 callbackUrl，保存返回的令牌。
  4. 报告送达；其字段写入申请记录，文件一并附上。
  5. 审查人员在同一界面上看到数据和登记机关文件。

接口及字段取自 docs.fill-easy.com。所列机构、人物、公司及数值均为虚构。

公司报告包含什么。

CorpVerify 报告的 webhook，即您的系统收到的内容。/cra/poll 返回相同的数据。将鼠标悬停在注释上，可查看对应的行。
POST {callbackUrl} · application/json
{
  "event": "cra.report.completed",
  "requestId": "req_…",
  "timestamp": "2026-09-25T10:46:12+08:00",
  "data": {
    "reportMetadata": { "reportDate": "2026-09-25", "countryCode": "HK", "status": "completed" },
    "companyIdentification": { "companyName": { "english": "Silverkite Trading Limited" }, "companyId": "3182045" },
    "registrationDetails": { "incorporationDate": "2019-04-11", "status": { "english": "Live" } },
    "management": { "directors": [ … ], "companySecretary": { … } },
    "ownership": { "shareholders": [ … ] },
    "originalDocuments": [ { "type": "…", "status": "…", "fileName": "…pdf", "url": "https://…" } ]
  }
}
结构取自 docs.fill-easy.com；数值均为虚构，部分内容经删减。
  1. 1
    结构化部分

    识别信息、注册详情、管理层及所有权以字段形式提供；如登记机关提供，还包括股本、地点、经营及合规信息。

  2. 2
    原始文件

    登记机关自身的文件，每份注明类型、状态、文件名及链接。

  3. 3
    报告元数据

    报告生成时间、所属国家/地区，以及所请求的各年度文件哪些已就绪、哪些待处理。

  4. 4
    Webhook 信封

    事件、请求编号及发送时间。其中的数据与 /cra/poll 响应完全相同。

今天是数据 API，下一步是智能体 API。

目前，您的系统针对每项核查调用相应接口。智能体 API 将像邮件代理一样，接受以日常语言提出的请求。

数据 API

现已上线

针对所需核查调用相应接口，提供您掌握的输入信息。结果通过 webhook、轮询或在同一调用中返回。

POST /cra/request
{
  "countryCode": "HK",
  "companyId": "3182045",
  "callbackUrl": "https://…/hooks/fe"
}
  • 由您的系统选择每个接口
  • Webhook、轮询或即时返回
  • 文档见 docs.fill-easy.com

智能体 API

即将推出

描述您的需求。代理会判断需要在哪些数据源上运行哪些核查，遇到不明确之处会提出问题。

“为 Silverkite Trading、其新加坡
 母公司及 BVI 控股公司准备 KYB
 材料，并筛查每一位董事”
  • 从您的系统调用的邮件代理
  • 问题返回给您的系统作答
  • 尚未上线

智能体 API 尚未上线。上方请求仅用于说明思路，并非实际接口。

访问权限在为您的团队开通时配置。

每次调用都通过 x-client-id 请求头中的客户端 ID 进行认证。Fill Easy（填鸭）会在为您的团队开通时签发凭证。

开发期间，可在 KYC 及 CorpVerify 请求中发送 dryRun，获取样本结果，不会调用数据源，也不会计费。

每项结果都能找回对应记录

  1. tok_9f1c…在请求时您会即时获得令牌和请求编号。如需要，可添加您自己的 externalRefId。
  2. tok_9f1c…在结果上webhook 附带请求编号；KYC 结果会原样返回您的 externalRefId。
  3. tok_9f1c…回到记录您的系统将结果匹配到其来源的申请。
文档
docs.fill-easy.com
认证方式
x-client-id 请求头
交付方式
Webhook、轮询或在同一调用中返回
智能体 API
即将推出

关于 API 的常见问题

没有找到答案？ 咨询我们的团队

通过 Fill Easy API 可以获取哪些数据？

覆盖 60+ 个司法管辖区的公司登记数据及文件、香港土地查询、香港及中国内地的个人 KYC 核查、证件及人脸核验，以及政府数字身份，均使用同一套凭证。

API 文档在哪里？

在 docs.fill-easy.com，包含每个接口、请求与响应，以及 webhook 信封。

API 如何认证？

每次调用都在 x-client-id 请求头中携带您的客户端 ID。Fill Easy 会在为您的团队开通时签发凭证。

API 使用 webhook 还是轮询？

传入 callbackUrl，结果就绪后即推送给您，采用包含事件名称及请求编号的标准信封。使用令牌轮询仍可作为备用方式。KYC Hong Kong 的筛查及登记册查询，以及直接证件核验，会在同一调用中返回结果。

公司报告需要多长时间？

对于自动获取的情况，例如提供公司编号的香港公司，通常 5 分钟内返回。人工获取可能需要数个工作日；期间您可以轮询查询其状态。

公司报告包含哪些内容？

识别信息、注册、管理层及所有权等结构化部分；如登记机关提供，还包括股本、地点、经营及合规信息；登记机关原始文件，每份附链接；以及报告日期、国家/地区等报告元数据。

如何将结果与我们自己的记录匹配？

每次请求都会即时返回令牌和请求编号，您也可以添加自己的 externalRefId。webhook 附带请求编号，KYC 结果会原样返回您的 externalRefId。

能否在不计费的情况下测试？

可以。设置了 dryRun 的请求会返回样本结果，不会调用数据源，也不会计费。

能否查看已计费的项目？

可以。计费接口会返回指定时间范围内计入您账户的项目。

API 和邮件代理可以一起使用吗？

可以。两者使用相同的数据源，因此一个团队可以通过邮件下单，同时您的系统调用 API。

什么是智能体 API？

从您的系统调用的邮件代理：以日常语言发送请求，代理会判断需要运行哪些核查。它即将推出；数据 API 现已上线。

如何获取访问权限？

请联系销售团队。Fill Easy 服务企业客户，会在为您的团队开通时签发凭证。

无需改变团队的工作方式，即可迁移您的查询订单。

联系销售团队