Verified data inside your systems.

REST APIs for company registries, land records, KYC checks on people and government digital identity. Results come back as structured JSON with the source documents, by webhook or polling.

Documentation
docs.fill-easy.com
  • Company, land, KYC and eID APIs
  • Webhook or polling
  • Agentic API coming soon
Read the API docsTalk to sales
onboarding-service → Fill Easy API
POST /cra/request
x-client-id: ••••••••
{
  "countryCode": "HK",
  "companyId": "3182045",
  "callbackUrl": "https://onboarding.bank.example/hooks/fe"
}
200 OK · token issued, report follows by 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://…" } ]
  }
}
  • Report stored on application APP-20931
  • Registry documents attached
Endpoints and fields from docs.fill-easy.com. Values are invented.

Every API, in one place.

Company and property records, KYC checks on people, and government digital identity, all under one set of credentials. Open a card to see its endpoints.

Companies and property

CorpVerify

Webhook or poll

Company registry data and documents across 60+ jurisdictions: search by name, base information, filings, litigation, and full reports with the original registry documents.

8 endpoints
  • POST/cra/{countryCode}/search/companiesSearch companies by name
  • POST/cra/{countryCode}/search/companyCompany base information
  • POST/cra/{countryCode}/search/documentsCompany documents on file
  • POST/cra/{countryCode}/search/irdHong Kong IRD Business Register search
  • POST/cra/{countryCode}/search/litigationLitigation records
  • POST/cra/requestRequest a report or document
  • POST/cra/pollPoll a report
  • GET/cra/infoCountries and document types
Docs

Land Registry Report

Webhook or poll

Search the Hong Kong Land Registry by address and retrieve official land documents.

3 endpoints
  • POST/lra/searchSearch address records
  • POST/lra/requestRequest a land report
  • POST/lra/pollPoll a report
Docs

KYC on people

KYC China

Webhook or poll

Identity, face match, bank card, mobile, fraud blacklist, litigation and criminal record checks on mainland residents. One request fans out to every check your inputs allow, or only the products you name.

2 endpoints
  • POST/kyc/cn/requestRun checks
  • POST/kyc/cn/pollPoll the result
Docs

KYC Hong Kong

Same call, mostly

AML, sanctions and PEP screening, lookups on the SFC, MPFA and IA licence registers with a page print of the register entry, and the Companies Registry directors index.

6 endpoints
  • POST/kyc/hk/screeningAML, sanctions and PEP screening
  • POST/kyc/hk/sfcSFC licensed person lookup
  • POST/kyc/hk/mpfaMPFA intermediary lookup
  • POST/kyc/hk/iaIA insurance intermediary lookup
  • POST/kyc/hk/directorCR directors index search
  • POST/kyc/hk/director/pollPoll the directors index search
Docs

KYC Licensee

Webhook or poll

One request screens an insurance intermediary candidate: IA, SFC and MPFA registers, court records, AML screening and, with a mainland ID, the mainland background checks. One consolidated result.

2 endpoints
  • POST/kyc/licenseeStart screening
  • POST/kyc/licensee/pollPoll the result
Docs

Facial & ID Scan

Webhook, poll or direct

ID document verification, face match and passive liveness, on a Fill Easy hosted page or directly from your own app.

3 endpoints
  • POST/ocr/authStart a hosted session
  • POST/ocr/pollPoll the result
  • POST/ocr/verifyVerify images directly
Docs

Digital identity

iAM Smart

User consents, then poll

Hong Kong's eID: sign-in, form filling with consented profile data, hash and PDF signing, including anonymous flows that need no prior login.

9 endpoints
  • POST/iamsmart/v2/request/authAuthentication
  • POST/iamsmart/v2/request/formfillingForm filling
  • POST/iamsmart/v2/request/signingSigning
  • POST/iamsmart/v2/request/pdf-signingPDF signing
  • POST/iamsmart/v2/request/reauthRe-authentication
  • POST/iamsmart/v2/request/formfilling-anonymousAnonymous form filling
  • POST/iamsmart/v2/request/signing-anonymousAnonymous hash signing
  • POST/iamsmart/v2/request/pdf-signing-anonymousAnonymous PDF signing
  • POST/iamsmart/v2/callback/clientPoll data
Docs

Singpass

User consents, then poll

Singapore's eID: verify a person, and retrieve MyInfo and MyInfo Business data with consent.

4 endpoints
  • POST/sgid/request/qrVerify
  • POST/sgid/request/authMyInfo
  • POST/sgid/request/auth-bizMyInfo Business
  • POST/sgid/callback/clientPoll data
Docs

Sino Connect

SDK scan, then poll

China eID: read the resident ID card by NFC with the Fill Easy SDK, and compare a live face with the card portrait.

3 endpoints
  • POST/sino-connect/nfc/callbackNFC poll
  • POST/sino-connect/face-rec/requestFace recognition request
  • POST/sino-connect/face-rec/callbackFace recognition poll
Docs

UAE Pass

User consents, then poll

The UAE's national digital identity: authenticate a person and request document presentation.

4 endpoints
  • POST/uaepass/request/authAuthentication
  • POST/uaepass/request/presentationRequest document presentation
  • POST/uaepass/pollPoll data
  • POST/uaepass/logoutLogout
Docs

Account

Billing

Same call

The items billed to your account over a time range, for reconciliation with your own records.

1 endpoint
  • GET/core/billingBilled items for a time range
Docs

The data lands where the decision is made.

Your systems call the API at the moment they need evidence, and the result is posted straight back to them. Nobody re-keys a registry extract or chases a PDF.

What calls it

  • Onboarding flowA business applies; the company report runs before approval
  • Case managementAn analyst opens a case; KYC results are attached
  • Periodic reviewA scheduled job re-screens people and entities due for review
  • Data platformStructured fields feed your warehouse and risk models
Event log · onboarding-service
Application APP-20931
  1. Your systemPOST /cra/request with callbackUrl
  2. API200 OK, token tok_9f1c…
  3. APIwebhook cra.report.completed
  4. Your systemstores the report fields on the application
  5. Your systemattaches the original registry documents
  • Webhook, with polling as a fallback
  • Original registry documents
  • dryRun for testing without charge
Endpoints and fields from docs.fill-easy.com. Values are invented.

Where it comes from

  • Company registries60+ jurisdictions, with original documents
  • Hong Kong Land RegistryAddress search and land documents
  • KYC sourcesWatchlists, HK licence registers, mainland government, carrier and bank records
  • Government digital identityiAM Smart, Singpass, China eID, UAE Pass

What your systems keep

  • Structured fields

    Registration details, management, ownership and share capital, ready to store and compare.

  • Original documents

    The registry's own documents, linked on the report for reviewers and auditors.

  • Report metadata

    The report date, the country and the status of every requested document.

  • The request trail

    A token and request ID on every call, and your own reference where you send one.

How teams wire it in.

Five integrations on five different APIs: the situation, the call, what comes back, and how it runs day to day.

The situationSmall businesses open accounts in the bank's app. Before an application reaches a reviewer, the onboarding service needs the company's registry report.

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

What comes back

Straight away
A token to poll with if the webhook is missed
Webhook
cra.report.completed
Report
Registration details, management, ownership, share capital
Documents
The original registry documents, linked
Timing
Automated for Hong Kong with a company ID; typically within 5 minutes

How it runs

  1. A customer enters the business name in the app.
  2. /cra/HK/search/companies returns the matching company and its ID.
  3. The service calls /cra/request with a callbackUrl and stores the token.
  4. The report arrives; its fields are written to the application and the documents attached.
  5. The reviewer sees the data and the registry documents on one screen.

Endpoints and fields from docs.fill-easy.com. The firms, people, companies and values are invented.

What a company report carries.

The webhook for a CorpVerify report, as your system receives it. The same data is returned by /cra/poll. Hover a note to see its lines.
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://…" } ]
  }
}
Structure from docs.fill-easy.com; values are invented and some sections are shortened.
  1. 1
    Structured sections

    Identification, registration details, management and ownership as fields, plus share capital, location, operations and compliance where the registry provides them.

  2. 2
    Original documents

    The registry's own documents, each with its type, status, file name and a link.

  3. 3
    Report metadata

    When the report was produced, for which country, and which requested years are ready or pending.

  4. 4
    The webhook envelope

    The event, the request ID and when it was sent. The data inside is identical to a /cra/poll response.

Data API today. Agentic API next.

Today your system calls the endpoint for each check. The agentic API will take a request in plain language, the way the email agents do.

Data API

Available

Call the endpoint for the check you want, with the inputs you have. Results come back by webhook, by polling or in the same call.

POST /cra/request
{
  "countryCode": "HK",
  "companyId": "3182045",
  "callbackUrl": "https://…/hooks/fe"
}
  • Your system chooses each endpoint
  • Webhook, polling or an immediate answer
  • Documented at docs.fill-easy.com

Agentic API

Coming soon

Describe what you need. The agent works out which checks to run across which sources, and asks when something is unclear.

"KYB pack for Silverkite Trading, its
 Singapore parent and the BVI holding
 company, plus screening on every director"
  • The email agent, called from your systems
  • Questions returned for your system to answer
  • Not available yet

The agentic API is not available yet. The request above shows the idea, not an interface.

Access is set up with your team.

Every call is authenticated with your client ID in the x-client-id header. Fill Easy issues credentials when your team is set up.

Send dryRun on the KYC and CorpVerify requests to get sample results without calling a source or being billed, while you build.

Every result finds its way back

  1. tok_9f1c…On the requestYou get a token and a request ID straight away. Add your own externalRefId if you like.
  2. tok_9f1c…On the resultThe webhook carries the request ID; KYC results echo your externalRefId.
  3. tok_9f1c…Back on the recordYour system matches the result to the application it came from.
Documentation
docs.fill-easy.com
Authentication
x-client-id header
Delivery
Webhook, polling or same call
Agentic API
Coming soon

Questions about the API

Not covered here? Ask our team

What can we access through the Fill Easy API?

Company registry data and documents across 60+ jurisdictions, Hong Kong land searches, KYC checks on people in Hong Kong and Mainland China, ID and face verification, and government digital identity, all under one set of credentials.

Where is the API documentation?

At docs.fill-easy.com, with every endpoint, request and response, and the webhook envelope.

How is the API authenticated?

Every call carries your client ID in the x-client-id header. Fill Easy issues credentials when your team is set up.

Does the API use webhooks or polling?

Pass a callbackUrl and the result is posted to you when it is ready, in a standard envelope with the event name and request ID. Polling with the token stays available as a fallback. KYC Hong Kong screening and register lookups, and direct ID verification, answer in the same call.

How long does a company report take?

Where retrieval is automated, such as Hong Kong with a company ID, typically within 5 minutes. Where it is manual it can take several business days; you can poll for its status meanwhile.

What does a company report contain?

Structured sections for identification, registration, management and ownership, plus share capital, location, operations and compliance where the registry provides them; the registry's original documents, each with a link; and report metadata such as the report date and country.

How do we match results to our own records?

Each request returns a token and a request ID straight away, and you can add your own externalRefId. The webhook carries the request ID, and KYC results echo your externalRefId.

Can we test without being billed?

Yes. Requests with dryRun set return sample results without calling a source or being billed.

Can we see what we have been billed?

Yes. The billing endpoint returns the items billed to your account over a time range.

Can we use the API and the email agents together?

Yes. They draw on the same sources, so one team can order by email while your systems call the API.

What is the agentic API?

The email agent, called from your systems: send a request in plain language and the agent works out which checks to run. It is coming soon; the data API is available now.

How do we get access?

Talk to sales. Fill Easy works with enterprise clients and issues credentials when your team is set up.

Move your search orders without changing how your team works.

Talk to sales