Retrieve UK Officer Report API
/company_house_officer_report/{api_reference}
Polls the status of a UK officer report queued via POST /company_house_officer_report. Returns 202 while compiling, 200 when ready with the full JSON payload: appointments, personal details and disqualifications. Append ?pdf=true for a PDF copy. Retrieval calls aren't billable.
Example Request
GETRequest Schema
api_reference
Returned by the create call.
pdf
PDF response when true.
Available Response Data
7 Data Pointsreport.officer_id, name, date_of_birth
YYYY-MM
etag, kind
personal-appointment or personal-disqualification
type
natural or corporate, is_corporate_officer boolean
disqualified boolean, report_date
ISO 8601
total_results, items_per_page, start_index
items array
each appointment with name, officer_role, appointed_on, resigned_on where applicable, appointed_to company_name, company_number, company_status, address, nationality, name_elements, country_of_residence, occupation, links, identification, is_pre_1992_appointment
disqualifications array {when disqualified requested}
case_identifier, disqualification_type, disqualified_from, disqualified_until, reason, company_names, heard_on, court_name
API Data Scale & Coverage tag
Unmatched data depth to power your compliance and verification workflows.
Technical Use Cases tag
Director appointment timeline
Use the appointments array (active first, then resigned) to render a chronological view of a director's career across UK companies.
Compliance-grade evidence
Use the PDF output for board packs, regulator submissions and dispute evidence.
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.
rocket_launch Implementation
What does the kind field tell me?
add
What does the kind field tell me?
Two values. personal-appointment for a standard officer appointments report, and personal-disqualification for a disqualified-officer report. The structure differs. Standard reports populate the items array. Disqualification reports populate the disqualifications array.
API Testing Sandbox tag
Test the Retrieve UK Officer 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.