Skip to content

Reference

UK registry-to-API field map

Map Companies House, Insolvency Service and HM Land Registry response fields, with source licences and known limits.

Updated 7 September 2026 9 min read

This map is a reading aid for the published OpenAPI contract. It names response paths exactly as they appear in the entity and risk schemas, then separates source facts from the response-level normalisation and derived risk logic.

First, read source accountability

Every entity response names sources_checked and sources_failed. The former records attempted sources; the latter gives the failed subset and a reason. Use them before relying on any source-derived field. A source omitted from the checked set was not assessed, and a source in sources_failed did not produce complete evidence.

Companies House: profile

RecordSourceAPI fields
Company identityCompanies Housech.name, ch.company_number, ch.status, ch.type, ch.incorporated_on, ch.dissolved_on
Classification and addressCompanies Housech.sic_codes, ch.registered_office_address, ch.postcode
Filing and history indicatorsCompanies Housech.accounts_overdue, ch.confirmation_overdue, ch.has_charges, ch.has_insolvency_history, ch.ch_fetched_at
Top-level normalisationDerived response envelopecompany_number, name, status, fetched_at

Companies House: people and charges

RecordSourceAPI fields
Persons with significant controlCompanies Housech_psc.persons[].name, nature_of_control, notified_on, nationality, country_of_residence
Officer recordCompanies Houseofficers.items[].officer_id, name, officer_role, appointed_on, appointed_before, resigned_on, nationality, country_of_residence
Officer identity detailsCompanies Houseofficers.items[].date_of_birth (month/year only), former_names, identification, identity_verification
Officer setCompanies Houseofficers.status, total_results, active_count, resigned_count, truncated, items, directors
Charge setCompanies Housecharges.status, total_count, satisfied_count, part_satisfied_count, outstanding_count, truncated, items
Charge detailCompanies Housecharges.items[].charge_number, status, created_on, delivered_on, satisfied_on, persons_entitled, classification, particulars, floating-charge fields

officers.status and charges.status use none, present, and unknown. Only none is a confirmed absence. The default officer list is active officers; ?include_resigned=true adds resigned records while the counts remain totals for the full set.

Insolvency and derived risk

RecordSourceAPI fields
Insolvency proceedingsThe Insolvency Serviceinsolvency.has_active_insolvency, insolvency.cases, insolvency.insolvency_fetched_at
Source accountabilityResponse envelopesources_checked, sources_failed
Confirmed riskDerived from assembled profilerisk_signals.score, flags[].code, severity, description, triggered_at
Risk uncertaintyDerived from source availabilityrisk_signals.score_is_floor, potential_score, coverage, indeterminate[].code, source, reason

Risk fields are a paid feature. In an entity response, an absent risk_signals object means it is not available to that key, not that no risk exists. The dedicated risk endpoint returns the object for eligible keys. See how to read risk uncertainty before applying a policy.

HM Land Registry: land holdings

RecordSourceAPI fields
Title held by the companyHM Land Registry (CCOD)land_holdings[].title_number, tenure, address (postcode only), price_paid, date_added
Title countsDerived from the full title listland_summary.total_count, returned_count, freehold_count, leasehold_count, truncated
Dataset currencyHM Land Registry (CCOD)land_data_as_at

Land holdings come from HM Land Registry's UK Companies that Own Property (CCOD) dataset and are returned to Growth and Enterprise keys. land_holdings is ordered newest first by date_added, with undated titles last. ?land_limit= (1–200) keeps only the newest titles; land_summary always counts the full list, and truncated is true when titles were left out. When land was not requested or failed, land_holdings is empty and the counts are zero, so read sources_checked and sources_failed first. The land source cannot be requested on its own; pair it with another source, for example ?sources=ch,land.

Known data limits

  • PSC dates of birth are not returned or retrieved.
  • Officer date of birth, when present, is month and year only; no day is returned.
  • charges.truncated and officers.truncated mean their items array is not complete.
  • For the CCOD dataset, property addresses are postcode-only or null because full-address redistribution is not covered by the applicable PAF licence.
  • CCOD covers England and Wales; Scotland and Northern Ireland use separate registries and are not currently covered.
  • CCOD price_paid is null when HM Land Registry recorded no price; null is not a zero value.
  • freehold_count plus leasehold_count can be less than total_count when a title's tenure is not recorded as either.

Licences and attribution

Companies House and The Insolvency Service public-sector information is licensed under the Open Government Licence v3.0. Information produced by HM Land Registry is © Crown copyright and database right; it is licensed for value-added use and must not be redistributed as a standalone dataset. If you republish source material obtained through Rotuli, preserve the required attribution and do not imply government endorsement.

For source cadence, freshness, and the complete attribution wording, see Data sources. For full request and response schemas, use the API reference alongside the versioned OpenAPI document.