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 forlocalName, 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)
- Format:
FCprefix (e.g.,FC022268) - Features: Full company data + UK establishments
- Establishments: UK branches/offices
- Format:
BRprefix (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)
- 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