United Kingdom

Data Sources
Company Identifiers
Search Capabilities
Quirks & Gotchas
Mappings
Data Availability
Example API Responses

Data Sources

All UK company data is sourced from the Companies House API, the official public data API operated by Companies House — the UK executive agency responsible for incorporating and dissolving limited companies. Companies House traces its origins to 1844, when the Joint Stock Companies Act first enabled companies to be incorporated by registration. There is a single data source for all UK entities. No priority chain or fallback logic is needed — all data flows through one unified API.

All company types

Companies House Public Data API (api.company-information.service.gov.uk) — Provides structured company profile data including company name, status, legal form, registered address, SIC codes, officers (directors and secretaries), and Persons with Significant Control (PSCs). This is our sole source for all UK company information (company profile, officers, PSCs, establishments).
Companies House Document API (document-api.company-information.service.gov.uk) — Used to retrieve the actual PDF content of filed documents from the filing history (accounts, incorporation documents, confirmation statements, resolutions, etc.).

The Companies House API is a free, open API. All company data and documents are available at no charge. Rate limits apply (600 requests per 5 minutes per API key).

How data is fetched

For a company profile request, the system makes three parallel API calls to Companies House:

Company profile (/company/{number}) — name, status, legal form, address, SIC codes, jurisdiction, previous names
Officers (/company/{number}/officers) — directors, secretaries, and other officers (up to 2,000 per request)
Persons with Significant Control (/company/{number}/persons-with-significant-control) — individuals and corporate entities with significant control

These are combined and mapped into the unified Topograph data model, then enriched with AI-powered parsing for standardization of status, legal form, activity codes, and officer roles.

Company Identifiers

Query Identifiers

Company Type	Format	Example	Notes
Standard UK companies	8 digits	`12345678`	Includes Ltd, PLC, LLP, etc.
Overseas companies	FC + 6 digits	`FC022268`	Foreign companies registered in the UK
UK establishments	BR + 6 digits	`BR011501`	UK branches of overseas companies
Scottish companies	SC + 6 digits	`SC123456`	Companies registered in Scotland
Northern Ireland companies	NI + 6 digits	`NI012345`	Companies registered in Northern Ireland

All company numbers are 8 characters. Numeric-only numbers are zero-padded (e.g., 03789983). Prefixed numbers use 2-letter prefix + 6 digits.

Identifiers in API Response

Identifier Type	Format	Example	Notes
`companiesHouseNumber`	8 characters	`03789983`	Always present — the primary identifier
`jurisdiction`	String	`england-wales`	Jurisdiction within the UK (when available)

The UK does not use VAT numbers as company identifiers in the Companies House register. UK VAT numbers (format: GB + 9 digits) are managed by HMRC, not Companies House.

Search Capabilities

Search Type	Pattern	Example	Match Type	Expected Results
By Company Number	8 digits	`03789983`	Exact	Single company (1 result)
By Name	Text string (2-160 chars)	`"TECHNOLOGY UK LIMITED"`	Fuzzy	Multiple results (active companies only)

Search uses both live API lookups and pre-built indexes. Company number searches perform a live lookup against the Companies House API for exact matching. Name searches query the Companies House search endpoint which returns active companies by default.

Use company number searches for best performance and exact matching. Name searches are restricted to active companies by default (restrictions: active-companies).

Quirks & Gotchas

Quirk	Details
Name format is SURNAME, Firstname	Companies House returns officer names in “SURNAME, Firstname” format. The system parses this automatically, splitting on the comma.
No direct shareholder API	Companies House does not expose a shareholders endpoint. Shareholders are AI-reconstructed from filing history documents (capital, confirmation statements, incorporation documents).
PSC = UBO (not shareholder)	The PSC (Persons with Significant Control) register maps to UBOs, not shareholders. Individual PSCs become UBOs; corporate and legal-person PSCs become Other Key Persons.
Ownership in ranges, not exact	PSC ownership is expressed as ranges (25-50%, 50-75%, 75-100%), not exact percentages. This is a Companies House data model limitation.
Resigned officers filtered out	Only active (non-resigned) officers are returned. Officers with a `resigned_on` date are excluded from the response.
SIC codes are UK-specific	UK SIC 2007 codes are 5 digits and identical to NACE Rev. 2 at the 4-digit level, with UK-specific subclasses at the 5th digit. NACE and ISIC mappings are AI-inferred.
All documents are free	Unlike many other jurisdictions, all UK Companies House documents are available at no charge.
Overseas companies have establishments	Companies with FC prefix are foreign companies registered in the UK. They may have UK establishment branches (BR prefix). Establishments are only fetched for FC-prefixed companies.
Super-secure PSCs	Some PSCs are classified as “super-secure” with protected details. These appear as “Protected Person with Significant Control” in the UBO data with no personal information.
Corporate PSCs are OKPs, not UBOs	Corporate and legal-person PSCs are mapped as Other Key Persons (with role “Person with Significant Control”), not as UBOs. Only individual PSCs become UBOs.
Secretaries are OKPs, not legal reps	Company secretaries (including corporate secretaries and nominee secretaries) are classified as Other Key Persons, not Legal Representatives.
Role includes occupation	When Companies House provides an officer’s occupation, the role `localName` is formatted as `“Mapped Role	Occupation”`(e.g.,`”Director	Managing Director”`).
Previous company names preserved	Companies that have changed names retain their historical names in the `legacyLegalNames` array.

Mappings

Company Status

Company status is determined deterministically from the Companies House API company_status field — no AI inference is involved.

Local Status	Standardized Status	Notes
`active`	Active	Company is currently active
`dissolved`	Closed	Company has been dissolved
`liquidation`	Closed	Company is in liquidation
`administration`	Under Insolvency Proceeding	Company is in administration
`voluntary-arrangement`	Unknown	Company under voluntary arrangement
`converted-closed`	Unknown	Company has been converted or closed
`insolvency-proceedings`	Unknown	Company is subject to insolvency proceedings
`registered`	Active	Overseas company registered in the UK
`removed`	Unknown	Company has been removed from the register
`open`	Active	Open (used for some company types)
`closed`	Closed	Closed

The mapping logic: active maps to Active; statuses containing liquidation or dissolved map to Closed; statuses containing administration map to Under Insolvency Proceeding; all others map to Unknown. The localName field always preserves the original Companies House status value.

Legal Forms

Legal forms are mapped deterministically from the Companies House company_type field to human-readable English descriptions. Since the UK is an English-speaking country, the localName and englishTranslation fields are identical. Standardization to Topograph types and ISO 20275 codes is AI-enriched.

Key Business Forms

Companies House Code	Legal Form (localName)	Standardized	ISO 20275
`ltd`	Private limited company	Limited Liability Company	SQXV
`plc`	Public limited company	Corporation	GKFN
`private-unlimited`	Private unlimited company	Sole Proprietorship	-
`private-unlimited-nsc`	Private unlimited company without share capital	Sole Proprietorship	-
`private-limited-guarant-nsc`	Private limited by guarantee without share capital	Limited Liability Company	-
`private-limited-guarant-nsc-limited-exemption`	Private Limited Company by guarantee without share capital, use of ‘Limited’ exemption	Limited Liability Company	-
`private-limited-shares-section-30-exemption`	Private Limited Company, use of ‘Limited’ exemption	Limited Liability Company	-
`old-public-company`	Old public company	Corporation	-
`converted-or-closed`	Converted / closed	Other	-
`unregistered-company`	Unregistered company	Other	-
`other`	Other company type	Other	-

Partnerships & LLPs

Companies House Code	Legal Form (localName)	Standardized	ISO 20275
`llp`	Limited liability partnership	Partnership	8VXR
`limited-partnership`	Limited partnership	Partnership	-
`scottish-partnership`	Scottish qualifying partnership	Partnership	-

Non-Profits & Charities

Companies House Code	Legal Form (localName)	Standardized	ISO 20275
`charitable-incorporated-organisation`	Charitable incorporated organisation	Nonprofit Organization	-
`scottish-charitable-incorporated-organisation`	Scottish charitable incorporated organisation	Nonprofit Organization	-

European & International Forms

Companies House Code	Legal Form (localName)	Standardized	ISO 20275
`european-public-limited-liability-company-se`	European public limited liability company (SE)	Corporation	-
`united-kingdom-societas`	United Kingdom Societas	Corporation	-
`eeig`	European Economic Interest Grouping (EEIG)	Other	-
`eeig-establishment`	European Economic Interest Grouping Establishment (EEIG)	Other	-
`ukeig`	United Kingdom Economic Interest Grouping	Other	-

Overseas & Branch Offices

Companies House Code	Legal Form (localName)	Standardized	ISO 20275
`oversea-company`	Overseas company	Branch or Representative Office	-
`registered-overseas-entity`	Overseas entity	Branch or Representative Office	-
`uk-establishment`	UK establishment company	Branch or Representative Office	-

Investment & Financial Entities

Companies House Code	Legal Form (localName)	Standardized	ISO 20275
`investment-company-with-variable-capital`	Investment company with variable capital	Other	-
`icvc-securities`	Investment company with variable capital	Other	-
`icvc-warrant`	Investment company with variable capital	Other	-
`icvc-umbrella`	Investment company with variable capital	Other	-
`assurance-company`	Assurance-company	Other	-
`protected-cell-company`	Protected cell company	Other	-

Other & Regional Forms

Companies House Code	Legal Form (localName)	Standardized	ISO 20275
`royal-charter`	Royal charter company	Other	-
`industrial-and-provident-society`	Industrial and Provident society	Cooperative	-
`registered-society-non-jurisdictional`	Registered society	Other	-
`northern-ireland`	Northern Ireland company	Other	-
`northern-ireland-other`	Credit union (Northern Ireland)	Other	-
`further-education-or-sixth-form-college-corporation`	Further education or sixth form college corporation	Government-Owned Entity	-

The localName field is deterministically mapped from Companies House company_type codes using a static lookup table. The standardized type and iso20275Code are AI-enriched and may evolve. Source: Companies House API enumerations.

Legal Representatives

Legal representatives are extracted from the Companies House officers endpoint. The classification of an officer as legal representative vs. other key person is deterministic: all secretary roles are Other Key Persons; all other active officer roles are Legal Representatives. The role localName is built by combining the mapped officer role with the occupation field (when available) using a " | " separator. For example, if the officer role is director and the occupation is Managing Director, the localName will be "Director | Managing Director". Both individuals and corporate entities can hold officer roles. Corporate officers are detected by the presence of an identification field.

Director & Management Roles (Legal Representatives)

Companies House Code	Mapped Role	Notes
`director`	Director	Most common role for UK companies
`corporate-director`	Director	Corporate entity serving as director
`nominee-director`	Nominee Director	Director appointed on behalf of another
`corporate-nominee-director`	Nominee Director	Corporate entity as nominee director
`cic-manager`	CIC Manager	Community Interest Company manager
`managing-officer`	Managing Officer	Used for overseas entities
`corporate-managing-officer`	Managing Officer	Corporate entity as managing officer

LLP Member Roles (Legal Representatives)

Companies House Code	Mapped Role	Notes
`llp-designated-member`	LLP Designated Member	Designated member of an LLP
`corporate-llp-designated-member`	LLP Designated Member	Corporate entity as LLP designated member
`llp-member`	LLP Member	Member of an LLP
`corporate-llp-member`	LLP Member	Corporate entity as LLP member

Partnership Roles (Legal Representatives)

Companies House Code	Mapped Role	Notes
`general-partner-in-a-limited-partnership`	General Partner in a Limited Partnership	Active management partner
`limited-partner-in-a-limited-partnership`	Limited Partner in a Limited Partnership	Passive investment partner

European / SE Roles (Legal Representatives)

Companies House Code	Mapped Role	Notes
`member-of-a-management-organ`	Member of a Management Organ	SE company management organ
`corporate-member-of-a-management-organ`	Member of a Management Organ	Corporate entity in management organ
`member-of-a-supervisory-organ`	Member of a Supervisory Organ	SE company supervisory organ
`corporate-member-of-a-supervisory-organ`	Member of a Supervisory Organ	Corporate entity in supervisory organ
`member-of-an-administrative-organ`	Member of an Administrative Organ	SE company administrative organ
`corporate-member-of-an-administrative-organ`	Member of an Administrative Organ	Corporate entity in administrative organ
`manager-of-an-eeig`	Manager of an EEIG	EEIG manager
`corporate-manager-of-an-eeig`	Manager of an EEIG	Corporate entity as EEIG manager

Overseas Entity Roles (Legal Representatives)

Companies House Code	Mapped Role	Notes
`person-authorised-to-accept`	Person Authorised to Accept	Service of documents
`person-authorised-to-represent`	Person Authorised to Represent	Representing the entity
`person-authorised-to-represent-and-accept`	Person Authorised to Represent and Accept	Both roles combined

Special Roles (Legal Representatives)

Companies House Code	Mapped Role	Notes
`judicial-factor`	Judicial Factor	Court-appointed factor (Scottish law)
`receiver-and-manager`	Receiver and Manager	Appointed by court or creditor

Other Key Persons

Secretary roles and corporate PSCs are classified as Other Key Persons. Secretary Roles:

Companies House Code	Mapped Role	Standardized
`secretary`	Secretary	Secretary
`corporate-secretary`	Secretary	Secretary
`nominee-secretary`	Nominee Secretary	Secretary
`corporate-nominee-secretary`	Nominee Secretary	Secretary

Corporate PSCs (from the PSC register):

PSC Kind	Mapped Role	Standardized
`corporate-entity-person-with-significant-control`	Person with Significant Control	Other
`legal-person-with-significant-control`	Person with Significant Control	Other

The secretary classification is deterministic — any officer role containing “secretary” in the officer_role field or occupation field is classified as an Other Key Person with standardized role Secretary. Corporate and legal-person PSCs are always Other Key Persons; only individual PSCs become UBOs.

Shareholders

The Companies House API does not provide a dedicated shareholders endpoint. Shareholders are extracted from filing history documents using AI-based reconstruction. Extraction Logic:

Source Document Category	When Used	Data Extracted
Capital documents	Share allotments, capital changes	Share structure and allottees
Confirmation statements	Annual returns with shareholding info	Current shareholders
Incorporation documents	Articles of association, initial subscribers	Initial shareholders
Resolution documents	Share-related decisions	Share transfers and changes

The system:

Filters available documents to categories likely to contain shareholder information (capital, annual-return, incorporation, resolution)
Downloads the selected PDFs (all free from Companies House)
Extracts shareholders using AI parsing
Returns reconstructed shareholder data with share percentages and ownership details

Ownership Fields:

Field	Description	Source
`sharePercentage`	Ownership percentage	AI-extracted from documents
`type`	Individual or Company	Determined from name patterns
`numberOfShares`	Number of shares held	AI-extracted from documents

Shareholder data is AI-reconstructed from filing history documents and is best-effort. For ownership transparency, the PSC register provides complementary information about individuals and entities with significant control (25%+ ownership or voting rights).

Activity Code Mapping

UK companies use UK SIC 2007 (UK Standard Industrial Classification of Economic Activities 2007) codes as returned by Companies House. UK SIC 2007 is maintained by the Office for National Statistics (ONS) and is identical to NACE Rev. 2 at the 4-digit level, with UK-specific 5-digit subclasses.

SIC 2007 (UK) → NACE Rev. 2 (European) → ISIC Rev. 4 (International)

Classification	Source	Example	AI Inferred?
SIC	Companies House API (`sic_codes`)	`62012`	No (official)
NACE	AI-mapped from SIC	`6201`	Yes
ISIC	AI-mapped from SIC	`6201`	Yes

SIC codes are formally parsed (never AI-inferred). The isAIInferred flag is always false for SIC codes. NACE and ISIC classifications are AI-enriched from the SIC codes since there is no deterministic mapping table in the system. Companies can have multiple SIC codes.

Data Availability

Data Availability Matrix

Data Type	Regular UK Companies	Overseas Companies (FC)	UK Establishments (BR)	Notes
Company Profile	✅ Async	✅ Async	✅ Async	From Companies House Public Data API
Legal Representatives	✅	✅	✅	Active directors from officers endpoint
Other Key Persons	✅	✅	✅	Secretaries + corporate PSCs
Shareholders	✅ (AI-reconstructed)	⚠️ Limited	❌	Reconstructed from filing documents
Ultimate Beneficial Owners	✅	⚠️ Limited	❌	From PSC register (individuals only)
Establishments	❌	✅	N/A	UK branches of overseas companies (FC prefix only)
Activity Codes (SIC)	✅	✅	⚠️	SIC codes from Companies House
Documents	✅	✅	⚠️ Limited	Free PDFs from filing history

Legend: ✅ Available | ❌ Not Available | ⚠️ Conditionally Available | Async = Asynchronous processing

Documents by Company Type

All UK company documents are sourced from the Companies House filing history and are free of charge.

Document Category	API Type	Format	SKU	Availability	Notes
Trade Register Extract	`tradeRegisterExtract`	PDF	`GBR_REGISTER_EXTRACT`	✅ All companies	Official Companies House report (generated via HTML-to-PDF)
Incorporation Documents	`articlesOfAssociation`	PDF	`GBR_STATUS`	✅ When filed	Articles of association and incorporation documents
Annual Accounts	`financialStatements`	PDF	`GBR_FINANCIAL_STATEMENTS`	✅ When filed	Annual accounts and financial statements
Capital Documents	Other	PDF	`GBR_STATUS`	✅ When filed	Share capital and structure changes
Officer Changes	Other	PDF	`GBR_STATUS`	✅ When filed	Director and secretary appointments/terminations
Confirmation Statements	Other	PDF	`GBR_STATUS`	✅ When filed	Annual confirmation statements (formerly annual returns)
Resolutions	Other	PDF	`GBR_STATUS`	✅ When filed	Company resolutions
Address Changes	Other	PDF	`GBR_STATUS`	✅ When filed	Registered office address changes
Charges / Mortgages	Other	PDF	`GBR_STATUS`	✅ When filed	Charges and mortgages registrations
Miscellaneous	Other	PDF	`GBR_STATUS`	✅ When filed	Other company filings

All UK company documents from Companies House are free. There is no per-document cost for retrieving any filing history documents or the trade register extract.

The Trade Register Extract is always available for all companies and is generated by fetching the company page HTML from Companies House and converting it to PDF. Filing history documents are fetched from the Companies House Document API with pagination support (up to 2,000 documents, 100 per page).

Example API Responses

All examples use placeholder data. Query: POST /company with { "id": "<id>", "countryCode": "GB", "dataPoints": ["companyProfile"] }

Active Private Limited Company (Ltd)

{
  "company": {
    "id": "12345678",
    "countryCode": "GB",
    "identifiers": { "companiesHouseNumber": "12345678", "jurisdiction": "england-wales" },
    "legalName": "EXAMPLE TECHNOLOGY LIMITED",
    "legacyLegalNames": ["EXAMPLE SOLUTIONS LIMITED"],
    "registrationDate": "2020-06-15",
    "status": {
      "localName": "active",
      "active": true,
      "statusDetails": { "status": "ACTIVE" }
    },
    "legalForm": {
      "localName": "Private limited company",
      "englishTranslation": "Private limited company",
      "standardized": "Limited Liability Company",
      "iso20275Code": "SQXV"
    },
    "activities": {
      "SIC": [{ "code": "62012", "description": "Business and domestic software development", "isAIInferred": false }],
      "NACE": [{ "code": "6201", "description": "Computer programming activities", "isAIInferred": true }],
      "ISIC": [{ "code": "6201", "description": "Computer programming activities", "isAIInferred": true }]
    },
    "legalAddress": {
      "addressLine1": "10 Innovation Drive",
      "city": "London",
      "postalCode": "EC2A 1AB",
      "countryCode": "GB"
    }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": { "localName": "Director", "englishTranslation": "Director", "standardized": "Director" },
      "individual": {
        "name": { "fullName": "SMITH, John Robert", "firstName": "John Robert", "lastName": "SMITH" },
        "birthDate": { "month": 3, "year": 1980 }
      },
      "startDate": "2020-06-15"
    },
    {
      "type": "individual",
      "role": { "localName": "Director", "englishTranslation": "Director", "standardized": "Director" },
      "individual": {
        "name": { "fullName": "JONES, Sarah", "firstName": "Sarah", "lastName": "JONES" },
        "birthDate": { "month": 11, "year": 1985 }
      },
      "startDate": "2021-01-10"
    }
  ],
  "otherKeyPersons": [
    {
      "type": "individual",
      "role": { "localName": "Secretary", "standardized": "Secretary" },
      "individual": {
        "name": { "fullName": "WILLIAMS, David", "firstName": "David", "lastName": "WILLIAMS" }
      }
    }
  ],
  "ultimateBeneficialOwners": [
    {
      "name": { "fullName": "Mr John Robert Smith", "firstName": "John", "lastName": "Smith" },
      "birthDate": { "month": 3, "year": 1980 },
      "nationality": "GB",
      "residenceAddress": { "addressLine1": "10 Innovation Drive", "city": "London", "postalCode": "EC2A 1AB", "countryCode": "GB" },
      "control": {
        "types": ["ownership-of-shares", "voting-rights"],
        "description": "Person with significant control: ownership-of-shares-75-to-100-percent, voting-rights-75-to-100-percent",
        "details": [
          { "type": "shares", "percentageRange": { "lower": 75, "upper": 100 } },
          { "type": "voting-rights", "percentageRange": { "lower": 75, "upper": 100 } }
        ]
      }
    }
  ]
}

Dissolved Public Limited Company (PLC)

{
  "company": {
    "id": "00987654",
    "countryCode": "GB",
    "identifiers": { "companiesHouseNumber": "00987654", "jurisdiction": "england-wales" },
    "legalName": "OLD INDUSTRIES PLC",
    "registrationDate": "1998-02-20",
    "status": {
      "localName": "dissolved",
      "active": false,
      "statusDetails": { "status": "CLOSED" }
    },
    "legalForm": {
      "localName": "Public limited company",
      "englishTranslation": "Public limited company",
      "standardized": "Corporation",
      "iso20275Code": "GKFN"
    },
    "activities": {
      "SIC": [{ "code": "28110", "description": "Manufacture of engines and turbines", "isAIInferred": false }]
    },
    "legalAddress": {
      "addressLine1": "1 Industrial Park",
      "city": "Birmingham",
      "postalCode": "B1 1AA",
      "countryCode": "GB"
    }
  },
  "legalRepresentatives": []
}

Note: Dissolved companies have active: false and may have no active officers. Resigned officers are filtered out, so a dissolved company may return an empty legalRepresentatives array.

Limited Liability Partnership (LLP)

{
  "company": {
    "id": "OC345678",
    "countryCode": "GB",
    "identifiers": { "companiesHouseNumber": "OC345678", "jurisdiction": "england-wales" },
    "legalName": "EXAMPLE CONSULTING LLP",
    "registrationDate": "2018-04-01",
    "status": {
      "localName": "active",
      "active": true,
      "statusDetails": { "status": "ACTIVE" }
    },
    "legalForm": {
      "localName": "Limited liability partnership",
      "englishTranslation": "Limited liability partnership",
      "standardized": "Partnership",
      "iso20275Code": "8VXR"
    },
    "activities": {
      "SIC": [{ "code": "69201", "description": "Accounting and auditing activities", "isAIInferred": false }]
    },
    "legalAddress": {
      "addressLine1": "20 Chancery Lane",
      "city": "London",
      "postalCode": "WC2A 1PL",
      "countryCode": "GB"
    }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": { "localName": "LLP Designated Member", "englishTranslation": "LLP Designated Member", "standardized": "Partner" },
      "individual": {
        "name": { "fullName": "BROWN, Alice", "firstName": "Alice", "lastName": "BROWN" },
        "birthDate": { "month": 7, "year": 1975 }
      },
      "startDate": "2018-04-01"
    },
    {
      "type": "individual",
      "role": { "localName": "LLP Member", "englishTranslation": "LLP Member", "standardized": "Partner" },
      "individual": {
        "name": { "fullName": "TAYLOR, Michael", "firstName": "Michael", "lastName": "TAYLOR" },
        "birthDate": { "month": 2, "year": 1982 }
      },
      "startDate": "2018-04-01"
    }
  ]
}

Note: LLPs use Designated Member and Member roles instead of Director. No secretary role in LLPs.

Overseas Company (FC prefix) with Establishments

{
  "company": {
    "id": "FC022268",
    "countryCode": "GB",
    "identifiers": { "companiesHouseNumber": "FC022268" },
    "legalName": "GLOBAL CORP SARL",
    "registrationDate": "2005-11-01",
    "status": {
      "localName": "registered",
      "active": true,
      "statusDetails": { "status": "ACTIVE" }
    },
    "legalForm": {
      "localName": "Overseas company",
      "englishTranslation": "Overseas company",
      "standardized": "Branch or Representative Office"
    },
    "legalAddress": {
      "addressLine1": "50 Oxford Street",
      "city": "London",
      "postalCode": "W1D 1BS",
      "countryCode": "GB"
    }
  },
  "legalRepresentatives": [
    {
      "type": "individual",
      "role": { "localName": "Director", "englishTranslation": "Director", "standardized": "Director" },
      "individual": {
        "name": { "fullName": "MUELLER, Hans", "firstName": "Hans", "lastName": "MUELLER" }
      }
    }
  ],
  "establishments": [
    {
      "name": "GLOBAL CORP UK BRANCH",
      "creationDate": "2005-11-01",
      "address": {
        "addressLine1": "50 Oxford Street",
        "city": "London",
        "postalCode": "W1D 1BS",
        "countryCode": "GB"
      }
    }
  ]
}

Note: Overseas companies (FC prefix) may include UK establishments. The establishments array lists UK branches/offices of the foreign parent company. Only companies with FC prefix trigger the establishments fetch.

UBO Response (dedicated datapoint)

Query with "dataPoints": ["ultimateBeneficialOwners"]:

{
  "ultimateBeneficialOwners": [
    {
      "name": {
        "fullName": "Mr John Robert Smith",
        "firstName": "John",
        "lastName": "Smith",
        "middleNames": ["Robert"]
      },
      "birthDate": { "month": 3, "year": 1980 },
      "nationality": "GB",
      "residenceAddress": {
        "addressLine1": "10 Innovation Drive",
        "city": "London",
        "postalCode": "EC2A 1AB",
        "countryCode": "GB"
      },
      "control": {
        "types": ["ownership-of-shares", "voting-rights", "appoint-and-remove-directors"],
        "description": "Person with significant control: ownership-of-shares-75-to-100-percent, voting-rights-75-to-100-percent, right-to-appoint-and-remove-directors",
        "details": [
          { "type": "shares", "percentageRange": { "lower": 75, "upper": 100 } },
          { "type": "voting-rights", "percentageRange": { "lower": 75, "upper": 100 } }
        ]
      }
    }
  ],
  "otherKeyPersons": [
    {
      "type": "company",
      "company": {
        "id": "87654321",
        "legalName": "HOLDING GROUP LIMITED",
        "countryCode": "GB",
        "identifiers": { "registrationNumber": "87654321" },
        "legalForm": { "localName": "Private limited company" },
        "legalAddress": { "addressLine1": "1 Finance Street", "city": "London", "postalCode": "EC1A 1BB", "countryCode": "GB" }
      },
      "role": { "localName": "Person with Significant Control", "standardized": "Other" }
    }
  ]
}

Note: UBOs come from the PSC register. Individual PSCs become UBOs with ownership/voting percentage ranges. Corporate and legal-person PSCs appear as Other Key Persons. Super-secure PSCs appear with fullName: "Protected Person with Significant Control" and no personal details.

Available Documents (filing history)

Documents are returned when "dataPoints": ["documents"] is requested.Always available:

API Category	Document	Notes
`tradeRegisterExtract`	Companies House company report	Free, always available

From filing history (when filed):

Filing Category	API Type	Notes
`incorporation`	`articlesOfAssociation`	Incorporation documents and articles
`accounts`	`financialStatements`	Annual accounts
`capital`	Other	Share capital changes
`officers`	Other	Officer appointments/terminations
`annual-return`	Other	Confirmation statements
`resolution`	Other	Company resolutions
`address`	Other	Registered office changes
`mortgage`	Other	Charges and mortgages
`change-of-name`	Other	Company name changes
`liquidation`	Other	Liquidation documents
`miscellaneous`	Other	Other filings

All documents are free (no per-document cost).

Western Europe

Northern Europe

Southern Europe

Central & Eastern Europe

Crown Dependencies & Offshore

Asia & Indian Ocean

Table of Contents

Data Sources

All company types

How data is fetched

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Company Status

Legal Forms

Legal Representatives

Other Key Persons

Shareholders

Activity Code Mapping

Data Availability

Data Availability Matrix

Documents by Company Type

Example API Responses

Western Europe

Northern Europe

Southern Europe

Central & Eastern Europe

Crown Dependencies & Offshore

Asia & Indian Ocean

​Table of Contents

​Data Sources

​All company types

​How data is fetched

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Search Capabilities

​Quirks & Gotchas

​Mappings

​Company Status

​Legal Forms

​Legal Representatives

​Other Key Persons

​Shareholders

​Activity Code Mapping

​Data Availability

​Data Availability Matrix

​Documents by Company Type

​Example API Responses

Table of Contents

Data Sources

All company types

How data is fetched

Company Identifiers

Query Identifiers

Identifiers in API Response

Search Capabilities

Quirks & Gotchas

Mappings

Company Status

Legal Forms

Legal Representatives

Other Key Persons

Shareholders

Activity Code Mapping

Data Availability

Data Availability Matrix

Documents by Company Type

Example API Responses