CorpVerify

CorpVerify provides company registry data and documents across 60+ jurisdictions worldwide. Reports include registration details, shareholder information, and financial data where available.

For the full list of supported countries and their capabilities, see CorpVerify Country Coverage.

Default Flow

Use /cra/{countryCode}/search/companies to find the Company ID
Pass this ID to /cra/request to initiate the report request
Poll /cra/poll with the returned token until the document is ready

Retrieval Methods

Automated Retrieval — For supported countries (for example Hong Kong), providing a valid companyId enables automatic document fetching. The /cra/poll endpoint typically resolves within 5 minutes. Use /cra/{countryCode}/search/companies to obtain valid Company IDs.

Manual Processing — For countries without automation or when companyId is unavailable, Fill Easy processes requests manually. This may take up to several business days. You can still poll /cra/poll to check status and retrieve the document when ready.

Note: The search endpoint may return an empty companyId for certain countries. In these cases, provide the companyName instead and the request will be processed manually.

Try It Out

Explore available regions, search for companies, and purchase documents using our web interface: search.fill-easy.com

Request

post

Initiate a company report request. Returns a JWT token for use with /cra/poll.

Required: countryCode (ISO 3166 alpha-2)

Recommended: companyId from /cra/{countryCode}/search/companies for faster automated processing.

Fallback: Provide companyName if companyId is unavailable — request will be processed manually.

Document Request: Provide documentId from /cra/{countryCode}/search/documents to request specific document.

Document Type: Each country has a defaultDocumentType (see /cra/info). Omitting documentType selects that default. To request a specific document, pass its name or alias from the country's documentTypes list.

Authorizations

x-client-idstringRequired

Client ID in x-client-id header.

x-client-secretstringRequired

Client Secret in x-client-secret header.

Body

Responses

200

Successfully initiated the request

application/json

tokenstringRequired

JWT token that encodes the request details and should be used in the /cra/poll endpoint to check the status and retrieve the document

Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U

dryRunbooleanOptional

set to true if sample PDF is being used - no cost incurred

400

Bad Request - Unsupported country code or sample not available

application/json

500

Internal server error

post

/cra/request

POST /cra/request HTTP/1.1
Host: sandbox.staging-api.fill-easy.com
x-client-id: YOUR_API_KEY
x-client-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "companyId": "0157548",
  "countryCode": "HK"
}

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U"
}

Poll Report

post

Poll this endpoint to check the status of a company registry report request. Keep polling until you receive a successful response with the message "CRA ready" and a presigned URL to download the document.

If the report is not ready yet, you will receive a 202 status code with the message "Report is pending".

Once the report is ready, the endpoint will bill the service and return a presigned URL valid for 7 days to download the PDF document.

Authorizations

x-client-idstringRequired

Client ID in x-client-id header.

x-client-secretstringRequired

Client Secret in x-client-secret header.

Body

tokenstringRequired

JWT token

Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8UPattern: ^[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+\.[A-Za-z0-9-_]*$

Responses

200

Report is ready

application/json

202

Report is still being processed

application/json

400

Bad Request - Invalid input parameters

application/json

500

Internal server error

post

/cra/poll

POST /cra/poll HTTP/1.1
Host: sandbox.staging-api.fill-easy.com
x-client-id: YOUR_API_KEY
x-client-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 120

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP4J3jVmNHl0w5N_XgL0n3I9PlFUP0THsR8U"
}

{
  "reportMetadata": {
    "reportDate": "2026-01-27",
    "countryCode": "HK",
    "status": "completed"
  },
  "originalDocuments": [
    {
      "type": "original",
      "status": "ready",
      "fileName": "CR_tgeNQ336mfLt.pdf",
      "url": "https://cra-bucket-ap-east-1-prod.s3.ap-east-1.amazonaws.com/processed/CR_tgeNQ336mfLt/original.pdf?X-Amz-Algorithm=..."
    },
    {
      "type": "translated",
      "status": "not_applicable"
    }
  ],
  "companyIdentification": {
    "companyName": {
      "english": "null",
      "local": "null"
    },
    "companyId": "31568815",
    "idType": "BRN",
    "previousCompanyNames": []
  },
  "registrationDetails": {
    "incorporationDate": "",
    "status": {
      "english": "Live",
      "local": "null"
    },
    "companyType": {
      "english": "Registered non-Hong Kong company",
      "local": "null"
    },
    "jurisdiction": "Hong Kong"
  },
  "location": {
    "registeredAddress": {
      "english": "1 QUEEN'S ROAD CENTRAL HONG KONG",
      "local": "null"
    },
    "principalPlaceOfBusiness": "null"
  },
  "management": {
    "directors": [
      {
        "name": {
          "english": "CLACKSON, PATRICK ANDREW",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "COYLE, JAMES",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "ELLIS, JULIET ANN",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "GODBEHERE, ANN FRANCES",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "GOH, YIU KIANG EULEEN",
          "local": "吳幼娟"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "GURNEY, KATHRYN LESLIE",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "HANNIGAN, DEIRDRE",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "MAHTANI, KAVITA",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "O'DONALD, LEWIS JOHN",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "ROBERTS, MICHAEL MURRAY",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "STRUTZ, ERIC WOLFGANG",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      },
      {
        "name": {
          "english": "WRIGHT, ANDREW MERLAY",
          "local": "null"
        },
        "identityDocuments": [],
        "address": "null",
        "appointmentDate": "null"
      }
    ],
    "companySecretary": "null",
    "legalRepresentative": "null"
  },
  "ownership": {
    "shareholders": [],
    "ultimateHoldingCompany": "null"
  },
  "shareCapital": {
    "issuedCapital": {
      "amount": 796969115,
      "currency": "GBP"
    },
    "paidUpCapital": {
      "amount": 0,
      "currency": "HKD"
    },
    "authorizedCapital": "null"
  },
  "operations": {
    "businessActivity": "null",
    "financialYearEnd": "null"
  },
  "compliance": {
    "registeredAgent": "null",
    "filingHistory": {
      "totalDocuments": 248,
      "summary": [
        {
          "category": {
            "english": "Directors & Company Secretaries"
          },
          "count": 64
        },
        {
          "category": {
            "english": "Other"
          },
          "count": 172
        },
        {
          "category": {
            "english": "Annual Return & Accounts"
          },
          "count": 11
        },
        {
          "category": {
            "english": "Charges"
          },
          "count": 1
        }
      ]
    },
    "changeHistory": "null",
    "riskInformation": "null",
    "intellectualProperty": "null"
  }
}

Search Companies by Name

post

This endpoint performs a search for companies in the respective country's Companies Registry by company name. It supports both English and Chinese company names and returns a list of matching companies.

Certain countries are unable to return a companyId - in those cases the idType in the response will be "Unavailable" and companyId will be an empty string.

The search will automatically detect if the input is in Chinese characters and adjust the search parameters accordingly.

The type of search is dependent on the country:

Substring search: KY, TH, PH, JP

Tokenized search (e.g. searching "PLE" will not result in "APPLE"): AU, SG

Left partial search: HK, BM, MY, FR

Partial name search: US

Authorizations

x-client-idstringRequired

Client ID in x-client-id header.

x-client-secretstringRequired

Client Secret in x-client-secret header.

Path parameters

countryCodestringRequired

ISO 3166 alpha-2 country code in lowercase.

Pattern: ^[a-z]{2}(-[a-z]{2})?$

Body

companyNamestringRequired

Company name to search (English or Chinese)

pageinteger · min: 1Optional

Page of results to return. Pagination support varies by country — for countries where it is not supported, only the first N results are returned regardless of this value. Check meta.page in the response to confirm whether pagination was applied.

Default: 1

Responses

200

Successfully retrieved matching companies

application/json

messagestringRequired

Response message

400

Bad Request - Unsupported country code or search not implemented

application/json

422

Too many results - search term is too broad

application/json

500

Internal server error

application/json

post

/cra/{countryCode}/search/companies

POST /cra/{countryCode}/search/companies HTTP/1.1
Host: sandbox.staging-api.fill-easy.com
x-client-id: YOUR_API_KEY
x-client-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "companyName": "WING KAI INVESTMENT COMPANY LIMITED"
}

{
  "message": "Success",
  "result": [
    {
      "companyName": "WING KAI INVESTMENT COMPANY LIMITED",
      "companyId": "0123456",
      "idType": "BRN",
      "status": "Live",
      "nameType": "current",
      "registrationDetails": [
        "Private Company",
        "Company Limited by Shares"
      ]
    }
  ]
}

Search Company Documents

post

This endpoint searches for and returns documents filed by a company with the Companies Registry. Documents are grouped by category (e.g., Annual Return, Director/Secretary Changes, Charges Filed, etc.).

You can optionally filter by document type and year to narrow down the results.

Document categories include: Annual Return, Director / Secretary Changes, Charges Filed, Incorporation & Name Change, Liquidation & Deregistration, Registered Office / Address, Share Capital, and Other.

Authorizations

x-client-idstringRequired

Client ID in x-client-id header.

x-client-secretstringRequired

Client Secret in x-client-secret header.

Path parameters

countryCodestringRequired

ISO 3166 alpha-2 country code.

Pattern: ^[a-z]{2}$

Body

companyIdstringRequired

Company ID (e.g., BRN for Hong Kong, ACN for Australia)

documentTypestringOptional

Optional filter by document type. (Country Specific)

HK: financialStatement, annualReturn
PH: GIS, AFS

documentYearstringOptional

Optional filter by year

Responses

200

Successfully retrieved documents as a flat array

application/json

messagestring · enumRequired

Status of the operation

Possible values:

400

Bad Request - Unsupported country code or search not implemented

application/json

500

Internal server error

application/json

post

/cra/{countryCode}/search/documents

POST /cra/{countryCode}/search/documents HTTP/1.1
Host: sandbox.staging-api.fill-easy.com
x-client-id: YOUR_API_KEY
x-client-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "companyId": "12104666"
}

{
  "message": "success",
  "result": [
    {
      "category": "Annual Return & Accounts",
      "documentYear": "2023",
      "documentName": "Annual Return",
      "pages": "5",
      "filingDate": "2023-12-15",
      "documentId": "12345678",
      "companyId": "12104666",
      "hasLinked": false
    },
    {
      "category": "Directors & Company Secretaries",
      "documentYear": "2023",
      "documentName": "Director Change",
      "pages": "2",
      "filingDate": "2023-11-10",
      "documentId": "12345679",
      "companyId": "12104666",
      "hasLinked": false
    }
  ]
}

Get Company Base Information

post

This endpoint retrieves the base information for a specific company from the Companies Registry using its Company ID.

For Hong Kong Companies, the information includes company name (English and Chinese), status, type, category, incorporation date, dissolution date (if applicable), and any remarks.

For other countries, the information includes company name, status, category, incorporation date, and other available details such as entity type, registration address, and remarks where applicable. The exact fields returned may vary depending on the data provided by each country’s registry.

Authorizations

x-client-idstringRequired

Client ID in x-client-id header.

x-client-secretstringRequired

Client Secret in x-client-secret header.

Path parameters

countryCodestringRequired

ISO 3166 alpha-2 country code.

Pattern: ^[a-z]{2}(-[a-z]{2})?$

Body

companyIdstringRequired

Company ID (e.g., BRN for Hong Kong, ACN for Australia)

Responses

200

Successfully retrieved company information

application/json

messagestring · enumRequired

Status of the operation

Possible values:

resultone ofOptional

Company base information object or null if not found

nullOptional

400

Bad Request - Unsupported country code or search not implemented

application/json

500

Internal server error

application/json

post

/cra/{countryCode}/search/company

POST /cra/{countryCode}/search/company HTTP/1.1
Host: sandbox.staging-api.fill-easy.com
x-client-id: YOUR_API_KEY
x-client-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "companyId": "12104666"
}

{
  "message": "success",
  "result": {
    "companyId": "12104666",
    "idType": "BRN",
    "companyName": "ABC COMPANY LIMITED",
    "localName": "ABC公司有限公司",
    "status": "Live",
    "registrationDetails": [
      "Private Company",
      "Company Limited by Shares"
    ],
    "incorporationDate": "2015-03-20",
    "remarks": ""
  }
}

Info

get

Returns metadata and a list of all countries supported by the CorpVerify service, including their automation status, available search capabilities, report contents, and the available document types per country. Each country includes a defaultDocumentType indicating which document is returned when documentType is omitted from a /cra/request call.

For an up-to-date version of the same data, please view the CorpVerify Country Coverage table.

Authorizations

x-client-idstringRequired

Client ID in x-client-id header.

x-client-secretstringRequired

Client Secret in x-client-secret header.

Responses

200

Successfully retrieved country information

application/json

400

Bad Request

500

Internal server error

get

/cra/info

GET /cra/info HTTP/1.1
Host: sandbox.staging-api.fill-easy.com
x-client-id: YOUR_API_KEY
x-client-secret: YOUR_API_KEY
Accept: */*

{
  "meta": {
    "totalCountries": 59,
    "automated": 6,
    "manual": 53,
    "searchable": 8
  },
  "countries": [
    {
      "name": "Hong Kong",
      "code": "HK",
      "region": "Asia",
      "sourceLanguage": "zh",
      "status": "automated",
      "search": {
        "originalDocuments": true,
        "companies": true,
        "company": true
      },
      "contents": {
        "registration": true,
        "shareholder": true,
        "financial": false
      },
      "defaultDocumentType": "Company Particulars",
      "documentTypes": [
        {
          "name": "Company Particulars",
          "contents": [
            "Company Name",
            "Unique Identifier",
            "Date of Incorporation"
          ],
          "source": "Companies Registry",
          "sampleUrl": "https://corpverify-samples.s3.us-east-1.amazonaws.com/HK/Company_Particulars.pdf"
        }
      ]
    }
  ]
}

Last updated 1 day ago

Good morning

hashtagDefault Flow

hashtagRetrieval Methods

hashtagTry It Out

hashtagRequest

hashtagPoll Report

hashtagSearch Companies by Name

hashtagSearch Company Documents

hashtagGet Company Base Information

hashtagInfo

Default Flow

Retrieval Methods

Try It Out

Request

Poll Report

Search Companies by Name

Search Company Documents

Get Company Base Information

Info