Retrieve Company House Report API
/company_house_report/{api_reference}
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
GETRequest Schema
api_reference
Returned by the create call.
pdf
When true, returns the report as a PDF.
Available Response Data
12 Data Pointsreport.company_name, company_number, company_status, type, subtype, jurisdiction
date_of_creation, date_of_cessation
when applicable
registered_office_address and registered_office_is_in_dispute flag
accounts block
reference dates, last and next filings
confirmation_statement
due dates and last made-up date
sic_codes array
code plus description per SIC
previous_company_names:
name, ceased_on, effective_from
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
filing_history
total_files, returned_files, array of files date, type, pages, barcode, category, description, document_id, transaction_id
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
report_date
ISO 8601 timestamp when generated
corporate_annotation, external_registration_number, foreign_company_details, branch_company_details, partial_data_available, super_secure_managing_officer_count, undeliverable_registered_office_address
API Data Scale & Coverage tag
Unmatched data depth to power your compliance and verification workflows.
Technical Use Cases tag
Compliance-grade PDF archival
Use ?pdf=true for board packs, compliance evidence and regulator submissions
Structured ingestion
Pull officers, PSCs and filing history into your case-management or KYC systems directly from JSON
Compliance & Security tag
Enterprise-grade infrastructure audited against the standards your regulators require.
Common Questions tag
Everything you need to know about implementation details and compliance infrastructure.
help_center General
Why is DOB truncated?
add
Why is DOB truncated?
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
What kinds of PSC are returned?
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).
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 AccessAccess to live sandbox environments requires manual approval from our compliance team.