Skip to content
New

Person Report API and New Zealand identity checks are now live.

See what's newarrow_forward
WatchEyeOnboarding & monitoring

Customer onboarding, screening and ongoing monitoring in one system, with real-time KYC and KYB alerts when a customer's risk changes.

Visit WatchEyearrow_forwardcheck_circleIncluded in the Global Data Portal
IDFEX ID CheckIdentity verification

One-to-one identity, document and data checks against the DVS and Australian data sources, run from the Portal or by API.

Visit IDFEX ID Checkarrow_forwardcheck_circleIncluded in the Global Data Portal
ID PassSelf-service verification

Customers verify their own identity and biometrics from a link on their phone. The result comes back to you, and they keep control of their data.

Visit ID Passarrow_forwardcheck_circleIncluded in the Global Data Portal
InsiightData quality

Verifies, corrects and enriches customer records so they stay accurate — one at a time or across your whole database.

Visit Insiightarrow_forwardcheck_circleIncluded in the Global Data Portal
Australian Death CheckDeceased data

The official national death data source. Match your records against it to find and remove deceased individuals.

Visit Australian Death Checkarrow_forwardcheck_circleIncluded in the Global Data Portal
QuesterMarketing lists

Build targeted, privacy-compliant Australian marketing lists with smart filters. Pay only for the records you download.

Visit Questerarrow_forwardcheck_circleIncluded in the Global Data Portal
verified_userVerify identities7 solutions

Confirm a person or business is who they claim to be: government IDs, biometrics, business registries and employment checks against authoritative Australian sources.

All solutionsarrow_forwardcheck_circleAvailable in the Portal and by API
policy_alertStay compliant6 solutions

Meet AUSTRAC obligations and understand customer risk: screening, risk assessment, fraud controls and investigation tools with evidence recorded for each check.

All solutionsarrow_forwardcheck_circleAvailable in the Portal and by API
databaseImprove your data3 solutions

Keep customer records accurate and put them to work: correct and enrich existing data, unify it into a single view, or build compliant marketing lists from opted-in records.

All solutionsarrow_forwardcheck_circleAvailable in the Portal and by API
monitoringWatchEye API14 categories

The WatchEye API gives programmatic access to everything in WatchEye: PEP and sanctions screening, identity checks, IDPass verifications, monitoring programs, events and reports.

View allarrow_forwardcheck_circleSandbox environment for integration testing
policyAML & screening6 use cases

Obligations under the AML/CTF Act, from screening at onboarding through to ongoing monitoring — with the evidence for each check recorded.

All use casesarrow_forwardcheck_circleMapped to the products and data that cover it
how_to_regOnboarding & identity3 use cases

Verifying who a customer, employee or account holder is — at sign-up and during ongoing checks — against authoritative Australian sources.

All use casesarrow_forwardcheck_circleMapped to the products and data that cover it
databaseData & enrichment4 use cases

Keeping customer records accurate, current and complete: validate contact detail, fill the gaps, locate people and remove deceased records.

All use casesarrow_forwardcheck_circleMapped to the products and data that cover it
Global Data
Portalarrow_forward
Productsexpand_more
Solutionsexpand_more
Use casesexpand_more
Dataexpand_more
APIarrow_forwardIndustriesarrow_forwardResourcesarrow_forwardAboutarrow_forwardContactarrow_forward Request a Demo
Talk to the team

9am–5pm AEST, Monday to Friday.

call03 9948 4089
UK Companies House

Retrieve Company House Report API

Retrieve Company House Report collects a company report that was ordered with Company House Report, using the reference that call returned. The report comes back as JSON or, on request, as a PDF document ready to file.

  • The full company report as JSON, with officers, persons with significant control and filing history, or the same report as a formatted PDF
  • Waits up to 30 seconds for the report, is not billed, and can be repeated until the report is returned
For developers

After the technical detail?

For the technical detail, go to the API documentation. It holds the request and response schema, the integration guides and the error codes for this endpoint.

  • Response schema and status codes
  • UK Companies House guide and sandbox companies
View developer documentation

This retrieval call is not billable. Production keys are issued once the account is approved.

Encrypted in transit and at rest Handled under the Australian Privacy Principles
What the check gives you

Collecting the company report once Companies House has produced it

A company report is generated in the background after it is ordered, normally within seconds. Retrieve Company House Report is the call that collects it. Your system supplies the reference from the original order and receives either the finished report or a status telling it to try again.

The finished report as JSON

A 200 response carries the full report: the company profile, officers with active ones first, filing history of up to 200 filings, persons with significant control, accounts, confirmation statement and previous names.

The same report as a PDF

Adding pdf=true returns the report as a PDF document in the response body instead of JSON.

Whether the report is ready

The call waits up to 30 seconds. If the report is still being generated it returns a 202 response, and your system repeats the call with the same reference.

A reference for the audit trail

Each retrieval carries its own API reference, separate from the reference of the original order, and the report carries the timestamp it was generated.

How a check runs

The order returns at once; this call carries the waiting

Company House Report returns immediately with a reference. This call holds the connection for up to 30 seconds and answers with the report, or with a 202 if it is not ready. Repeat with the same reference until the report is returned.

Poll with an exponential back-off. The sandbox company DELAYED REPORT LTD returns a 202 on the first poll so retry logic can be tested.

Reading the result

What each answer means for the subject in front of you

The status code tells your system whether it has the report, should wait, or has the wrong reference.

Ready

The report is returned

A 200 response carries the full report as JSON, or as a PDF when pdf=true was sent. Store it against the matter and stop polling.

Processing

The report is not ready yet

A 202 response means the report is still being generated. Repeat the call with the same reference, backing off between attempts.

Not found

No report matches the reference

A 404 response means no report was found for the reference supplied, or it belongs to another account or environment. Check the reference from the original order.

What it costs

A monthly subscription, drawn down as you run checks

Your subscription is credited to your account each month and each check consumes credits from it. If you go past the included amount, further checks are charged at a per-check rate. The rate depends on the volume you commit to, so the sales team is the fastest way to find where your business lands.

  • Volume-based pricing
  • No lock-in contract
How billing works
Subscribe monthly, spend it as credits
  • The monthly subscription arrives as credits on your account.
  • Each check draws down credits as it runs.
  • Checks beyond the included credits are billed per check.
  • Higher monthly volume moves you to a lower rate.
Talk to sales about volume
Questions

Questions we get asked about retrieving a Company House Report

Do we need a developer to implement this?
Yes. Retrieve Company House Report is a REST call that must be repeated until the report is ready, so a developer builds the polling into your system alongside the order. A sandbox with a deterministic test dataset is provided at no usage cost, so the integration can be built and tested before production keys are issued.
What does our system need to send?
The API reference returned by the Company House Report order, in the URL path. Optionally pdf=true to receive the report as a PDF document instead of JSON.
What comes back?
A 200 response with the full report when it is ready, together with a new API reference for this retrieval. A 202 response while the report is still being generated. A 404 if the reference is not found or belongs to another account or environment.
Is this call billed?
No. The retrieval call is not billable and can be repeated as often as needed until the report is returned. The Company House Report order is the billed call.
Where does the data come from?
The top-level fields come from the Companies House company profile, with officers, filing history and persons with significant control collected from the corresponding Companies House records. The report carries the timestamp it was generated.
Are the reports we retrieve stored by Global Data?
Personally identifiable information sent in a request is not stored or retained unless it is needed to process that request. Query data is stripped of PII before it is kept for audit. Data in transit and at rest is encrypted, and retention follows the Australian Privacy Act and the Australian Privacy Principles. Global Data is not a credit bureau and does not create an access footprint on any record.
Getting started

The first step to access is a conversation

New accounts begin with sandbox access, and production API keys are issued once the account has been commercially approved.

Call 03 9948 4089, 9am–5pm AEST Monday to Friday

Encrypted in transit and at rest
Handled under the Australian Privacy Principles
ISO 27001 Certified