​
🇬🇧 United Kingdom

​
Company Identifiers

The UK implementation provides comprehensive company identifiers through the Companies House API:

  • companiesHouseNumber: Primary company registration number (e.g., “03789983”)
  • jurisdiction: Company jurisdiction within the UK (e.g., “england-wales”, “scotland”, “northern-ireland”)

​
Search Capabilities

  • By company name (contains matching): search("TECHNOLOGY UK LIMITED")
  • By registration number: search("03789983")
  • Overseas companies (FC prefix): search("FC022268")
  • UK establishments (BR prefix): search("BR011501")

​
Activity Classifications

For activity codes, you will always receive the exact SIC codes as returned by Companies House, with AI mapping to international standards:

  • SIC Codes: UK Standard Industrial Classification codes (guaranteed accuracy)
  • NACE Mapping: European standard classification
  • ISIC Mapping: International Standard Industrial Classification

For legal forms, we have a finite number of possible values for localName, directly mapped to standardized classifications. The UK supports 40+ legal form classifications:

Legal FormSemaphore Standard
Private unlimited companySole Proprietorship
Private limited companyLimited Liability Company
Public limited companyCorporation
Old public companyCorporation
Private Limited Company by guarantee without share capital, use of ‘Limited’ exemptionLimited Liability Company
Limited partnershipPartnership
Private limited by guarantee without share capitalLimited Liability Company
Private Limited Company, use of ‘Limited’ exemptionLimited Liability Company
Assurance companyOther
Overseas companyBranch or Representative Office
European Economic Interest GroupingOther
Investment company with variable capitalTrust
Registered societyOther
Industrial and Provident SocietyCooperative
Northern Ireland companyOther
Credit unionOther
Northern Ireland otherOther
Limited liability partnershipPartnership
Royal charter companyOther
Unregistered companyOther
Other company typeOther
European public limited-liability company (SE)Corporation
UK establishmentBranch or Representative Office
Scottish partnershipPartnership
Charitable Incorporated OrganisationNonprofit Organization
Scottish Charitable Incorporated OrganisationNonprofit Organization
Further education or sixth form college corporationGovernment-Owned Entity
Community interest companyCooperative
NHS foundation trustGovernment-Owned Entity

​
Company Types Support

Regular UK Companies:

  • Format: 8-digit number (e.g., 03789983)
  • Features: Full company data, officers, PSCs, documents
  • Establishments: None (domestic companies)

Overseas Companies:

  • Format: FC prefix (e.g., FC022268)
  • Features: Full company data + UK establishments
  • Establishments: UK branches/offices

UK Establishments:

  • Format: BR prefix (e.g., BR011501)
  • Parent: Overseas company
  • Data: Branch-specific information

​
Officer Role Processing

The UK implementation uses formal parsing to process company officers with high accuracy and consistency:

​
Role Classification Logic

Legal Representatives vs Other Key Persons:

  • Directors → legalRepresentatives (signing authority)
  • Secretaries → otherKeyPersons (administrative/oversight roles)
  • Corporate officers → Detected by name patterns (LIMITED, LTD, PLC, etc.)

​
Role Name Priority

For maximum accuracy, we prioritize data sources in this order:

  1. Occupation field (primary source when available)
  2. Officer role mapping (fallback for standardized roles)

Examples:

  • Officer with occupation: "Managing Director" → role.localName: "Managing Director"
  • Officer with officer_role: "director" but no occupation → role.localName: "Director"

​
Role Standardization

All officer roles are enriched with standardized classifications:

  • Legal Representatives: SemaphoreStandardRoleEnum (Director, Manager, CEO, etc.)
  • Other Key Persons: OtherKeyPersonRoleEnum (Secretary, Auditor, Compliance Officer, etc.)
  • Enrichment: AI-powered mapping to international role standards

​
Data Quality Features

  • Active officers only: Resigned officers filtered out by default for cleaner datasets
  • Corporate detection: Automatic identification of corporate vs individual officers
  • Address parsing: Full UK address normalization with country code mapping
  • Name formatting: Standardized parsing of both individual and corporate names