Retrieve Company House Report API

GET
/company_house_report/{api_reference}
LIVE

Polls the status of a UK Companies House company report queued via POST /company_house_report. Returns 202 while compiling, 200 when ready with the full JSON payload. Append ?pdf=true for a formatted PDF copy. Retrieval calls aren't billable.

Example Request

GET
request.json
key Auth: BearerAuth
GET /company_house_report/fe4291ca-d831-4760-96df-c9cb03b3cd95
GET /company_house_report/fe4291ca-d831-4760-96df-c9cb03b3cd95?pdf=true

Request Schema

api_reference
Required
uuid · (path)

Returned by the create call.

pdf
Optional
boolean · (query)

When true, returns the report as a PDF.

Available Response Data

12 Data Points
01
monitor_heart

report.company_name, company_number, company_status, type, subtype, jurisdiction

02
schedule

date_of_creation, date_of_cessation

when applicable

03
location_on

registered_office_address and registered_office_is_in_dispute flag

04
tag

accounts block

reference dates, last and next filings

05
monitor_heart

confirmation_statement

due dates and last made-up date

06
data_object

sic_codes array

code plus description per SIC

07
person

previous_company_names:

name, ceased_on, effective_from

08
data_object

officers array

name, officer_id, officer_role, appointed_on, resigned_on where applicable, DOB truncated to YYYY-MM, nationality, country_of_residence, occupation, address, identification for corporate officers

09
data_object

filing_history

total_files, returned_files, array of files date, type, pages, barcode, category, description, document_id, transaction_id

10
data_object

persons_with_significant_control

kind, name, address, DOB YYYY-MM, country_of_residence, nationality, natures_of_control, identification, name_elements, notified_on, ceased / ceased_on, is_sanctioned, description

11
schedule

report_date

ISO 8601 timestamp when generated

12
location_on

corporate_annotation, external_registration_number, foreign_company_details, branch_company_details, partial_data_available, super_secure_managing_officer_count, undeliverable_registered_office_address

lock Full API documentation provided after vetting from our compliance team.
By The Numbers

API Data Scale & Coverage tag

Unmatched data depth to power your compliance and verification workflows.

50M+
Phone & Email Records
40M+
Adverse Court Records
2BN+
Australian Universe Records
18M+
Real Estate Records
7M+
Deceased Records
980M+
Social Media & Employment Records
Practical Applications

Technical Use Cases tag

picture_as_pdf

Compliance-grade PDF archival

Use ?pdf=true for board packs, compliance evidence and regulator submissions

analytics

Structured ingestion

Pull officers, PSCs and filing history into your case-management or KYC systems directly from JSON

Trust & Assurance

Compliance & Security tag

Enterprise-grade infrastructure audited against the standards your regulators require.

verified_user
ISO 27001 Certified
enhanced_encryption
AES-256 Encryption
public
Australian Data Sovereignty
Integration & Support

Common Questions tag

Everything you need to know about implementation details and compliance infrastructure.

help_center General

Why is DOB truncated?

add

Companies House publishes only the month and year of birth for officers and PSCs in most cases (for privacy). The report mirrors this. DOB appears as YYYY-MM in officer and PSC records.

rocket_launch Implementation

What kinds of PSC are returned?

add

Three kinds. individual-person-with-significant-control, corporate-entity-person-with-significant-control, and legal-person-person-with-significant-control. The natures_of_control array enumerates the specific control held (for example ownership-of-shares-75-to-100-percent, voting-rights-75-to-100-percent, right-to-appoint-and-remove-directors).

Try it Live

API Testing Sandbox tag

Test the Retrieve Company House Report API directly in your browser with live mock data and see instant results.

rocket_launch Request Sandbox Access

Access to live sandbox environments requires manual approval from our compliance team.