United Kingdom
🇬🇧 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
Legal Forms
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 Form | Semaphore Standard |
---|---|
Private unlimited company | Sole Proprietorship |
Private limited company | Limited Liability Company |
Public limited company | Corporation |
Old public company | Corporation |
Private Limited Company by guarantee without share capital, use of ‘Limited’ exemption | Limited Liability Company |
Limited partnership | Partnership |
Private limited by guarantee without share capital | Limited Liability Company |
Private Limited Company, use of ‘Limited’ exemption | Limited Liability Company |
Assurance company | Other |
Overseas company | Branch or Representative Office |
European Economic Interest Grouping | Other |
Investment company with variable capital | Trust |
Registered society | Other |
Industrial and Provident Society | Cooperative |
Northern Ireland company | Other |
Credit union | Other |
Northern Ireland other | Other |
Limited liability partnership | Partnership |
Royal charter company | Other |
Unregistered company | Other |
Other company type | Other |
European public limited-liability company (SE) | Corporation |
UK establishment | Branch or Representative Office |
Scottish partnership | Partnership |
Charitable Incorporated Organisation | Nonprofit Organization |
Scottish Charitable Incorporated Organisation | Nonprofit Organization |
Further education or sixth form college corporation | Government-Owned Entity |
Community interest company | Cooperative |
NHS foundation trust | Government-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:
- Occupation field (primary source when available)
- 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