Data Sources
All Jersey company data is sourced from the Jersey Financial Services Commission (JFSC), the sole official registrar of companies in Jersey. Data is retrieved through two complementary channels from the same source:- JFSC Registry Search API — A public JSON API (
jerseyfsc.org/umbraco/api/RegistryEntitiesSearch/GetResults) that provides basic entity information: legal name, registration number, status, legal form (company type), and registration date. Used for search and onboarding profile (basic company data). No authentication required. - JFSC Entity Profile Report — The official trade register extract PDF document, purchased on-demand from the JFSC Registry. Primary source for comprehensive company data including registered address, share capital, legal representatives (directors), secretary, and shareholders (when disclosed). Delivered via email after purchase through the JFSC online checkout.
The JFSC Registry Search API provides only basic company data. Detailed attributes (directors, shareholders, capital, address) require purchasing and AI-parsing the Entity Profile Report PDF. The report is automatically retrieved when a full company profile is requested.
How is the Entity Profile Report retrieved?
How is the Entity Profile Report retrieved?
The Entity Profile Report is obtained through a multi-step automated process:
- Automated Purchase: The system navigates the JFSC checkout flow to purchase the document
- Cloudflare Protection: The checkout page uses Cloudflare Turnstile; the system handles this automatically
- Email Delivery: The document is delivered via email (typically within 1 minute)
- Download: The PDF is downloaded from the time-limited email link (valid 14 days)
- Storage: The document is cached for 24 hours
- AI Parsing: Text is extracted and parsed by AI for structured data
Company Identifiers
Query Identifiers
| Company Type | Source | Format | Example | Notes |
|---|---|---|---|---|
| All entities | JFSC Registry | 4-7 digit numeric | 116051 | Official registration number |
Identifiers in API Response
Once you retrieve company data, theidentifiers object contains:
| Identifier Type | Format | Example | Found In |
|---|---|---|---|
registrationNumber | 4-7 digits | 116051 | All entities |
Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
|---|---|---|---|---|
| By Registration Number | 4-7 digits | 116051 | Exact | Single company (1 result) |
| By Name | Text string (2-100 chars) | "EXAMPLE HOLDINGS" | Fuzzy | Multiple results (up to 100 per page) |
Search uses the JFSC API directly. Both name and ID searches query the JFSC Registry Search API in real time. Name searches include previous/historical names to help find renamed entities.
Company Status
Company status is derived deterministically from the JFSC Registry status field, then AI-enriched with standardized status and closure reason.| Local Status | Standardized Status | Closure Reason | Notes |
|---|---|---|---|
| Active | Active | — | Entity is currently operating |
| Dissolved | Closed | — | Entity has been dissolved |
| Struck Off | Closed | Administrative Dissolution | Entity removed from register by JFSC |
| In Liquidation | Under Insolvency Proceeding | — | Entity is being liquidated |
| Cancelled | Closed | Voluntary Dissolution | Registration has been cancelled |
| Wound Up | Closed | — | Entity has been wound up |
| Removed | Closed | — | Entity has been removed from the registry |
For inactive entities (Dissolved, Struck Off, Cancelled, Wound Up, Removed), the Entity Profile Report is not available from the JFSC. This means legal representatives, shareholders, capital, and registered address cannot be extracted for inactive companies — only basic data (name, status, legal form, registration date) is returned from the search API.
Legal Forms
Jersey entities are classified by type from the JFSC Registry. The local name is preserved verbatim and AI-enriched with an English translation, standardized company type, and ISO 20275 (ELF) code.Private & Public Companies
| Local Name | Standardized | ISO 20275 | Notes |
|---|---|---|---|
| Registered Company Private | Limited Liability Company | SQXV | Most common company type (private limited) |
| Registered Company Public | Corporation | — | Public limited company |
Partnerships
| Local Name | Standardized | ISO 20275 | Notes |
|---|---|---|---|
| Limited Partnership | Partnership | UBWU | LP structure |
| Limited Liability Partnership | Partnership | — | LLP structure |
| Separate Limited Partnership | Partnership | — | SLP with separate legal personality |
| Incorporated Limited Partnership | Partnership | — | ILP with separate legal personality |
Special Entities
| Local Name | Standardized | ISO 20275 | Notes |
|---|---|---|---|
| Incorporated Cell Company | Corporation | — | Company with segregated cells |
| Protected Cell Company | Corporation | — | Company with protected cells |
| Foundation | Nonprofit Organization | — | Jersey foundation |
Because legal form standardization and ISO 20275 assignment are AI-enriched, exact mappings may evolve. The local JFSC entity type is always preserved verbatim in the
localName field.Legal Representatives
Legal representatives are extracted from the Entity Profile Report PDF using AI parsing. The report lists directors and secretary in a “Directors and Secretary” or equivalent section.| Role | Classification | Standardized | Notes |
|---|---|---|---|
| Director | Legal Representative | Director | Individual or corporate directors |
Corporate directors are supported — when a company serves as a director, it is marked as type
company (legal entity). Individual directors include first name, last name, birth date (month/year), nationality, and residence address when available in the document.Other Key Persons
| Role | Classification | Standardized | Notes |
|---|---|---|---|
| Secretary | Other Key Person | Secretary | Individual or corporate secretary (optional) |
Legal representatives and other key persons are only available for active entities. Inactive entities (Dissolved, Struck Off, Cancelled) do not have an Entity Profile Report available, so no directors or secretaries can be extracted.
Shareholders
Shareholders are extracted from the Entity Profile Report PDF using AI parsing when shareholder information is disclosed in the document.Extraction Logic
| Source | When Used | Data Extracted |
|---|---|---|
| Entity Profile Report (Members/Shareholders section) | Active entities only | Shareholder name, number of shares, share class, ownership percentage |
Ownership Fields
| Field | Description | Source |
|---|---|---|
type | Individual or Company | AI-inferred from name format (e.g., “Ltd” suffix = company) |
sharePercentage | Ownership percentage | AI-calculated from shares held vs. total issued shares |
numberOfShares | Number of shares held | AI-extracted from document |
Share Types
| Share Class | Description |
|---|---|
| Ordinary shares | Standard voting shares |
| Preference shares | Preferential dividend rights |
| Management shares | Often held by directors |
Private Jersey companies are not required to publicly disclose shareholders. When shareholder data is not in the Entity Profile Report, an empty array is returned. Shareholder data is never available for inactive entities.
Activity Code Mapping
Jersey does not provide activity codes or industry classification through the JFSC Registry. There are no SIC, NACE, or ISIC codes available for Jersey companies.The JFSC Registry does not include industry classification data in its company records. As a result, no activity codes (NACE, ISIC, SIC, or local classification) are returned for Jersey entities.
Data Availability Matrix
| Data Type | Active Entities | Inactive Entities | Notes |
|---|---|---|---|
| Company Profile (basic) | ✅ Sync | ✅ Sync | Name, status, legal form, registration date from search API |
| Company Profile (full) | ✅ Async (~1 min) | ❌ | Requires Entity Profile Report (not available for inactive) |
| Registered Address | ✅ | ❌ | From Entity Profile Report or entity page HTML |
| Share Capital | ✅ | ❌ | From Entity Profile Report (AI-parsed) |
| Legal Representatives | ✅ | ❌ | AI-extracted from Entity Profile Report |
| Other Key Persons | ✅ | ❌ | Secretary, AI-extracted from Entity Profile Report |
| Shareholders | ⚠️ When disclosed | ❌ | Private companies not required to disclose |
| Ultimate Beneficial Owners | ❌ | ❌ | Not available through JFSC |
| Establishments | ❌ | ❌ | Not provided by JFSC |
| Activity Codes | ❌ | ❌ | JFSC does not provide industry classification |
| Documents (Entity Profile Report) | ✅ | ❌ | Trade register extract; active entities only |
Documents by Company Type
All Entity Types
| Document Type | API Category | Format | SKU | Availability | Notes |
|---|---|---|---|---|---|
| Entity Profile Report (Uncertified) | tradeRegisterExtract | jey-trade-register-extract | ✅ Active entities only | Official JFSC company registration report |
Document Caching: Entity Profile Reports are cached for 24 hours after retrieval to avoid redundant purchases. Subsequent requests within 24 hours return the cached version.
Example API Responses
All examples use placeholder data. Query:POST /company with { "id": "<id>", "countryCode": "JE", "dataPoints": ["companyProfile"] }
Active Private Company (with directors and shareholders)
Active Private Company (with directors and shareholders)
Inactive Company (Cancelled LP -- basic data only)
Inactive Company (Cancelled LP -- basic data only)
Available Documents (active company)
Available Documents (active company)
Documents are returned when
All documents are PDF format in English.
"dataPoints": ["availableDocuments"] is requested.| API Category | Document | Notes |
|---|---|---|
tradeRegisterExtract | Entity Profile Report (Uncertified) | Active entities only; ~60 second delivery |
Quirks & Gotchas
| Quirk | Details |
|---|---|
| No data for inactive entities | The Entity Profile Report is only available for active companies. Dissolved, Struck Off, Cancelled, Wound Up, and Removed entities return only basic data (name, status, legal form, registration date) with no directors, shareholders, address, or capital. |
| Shareholders often undisclosed | Private Jersey companies are not required to publicly disclose shareholders. When shareholder data is not in the Entity Profile Report, an empty array is returned. |
| Wholly-owned subsidiary pattern | Many Jersey companies have only 1 share issued despite higher authorized capital. A single shareholder with 1 share is correctly interpreted as 100% ownership. |
| Document delivery via email | The Entity Profile Report is purchased from JFSC and delivered via email. Processing takes approximately 1 minute but can take up to 30 minutes in edge cases. |
| No activity codes | The JFSC does not provide industry classification (SIC, NACE, ISIC) for Jersey companies. Activity codes are not returned. |
| AI-parsed legal representatives | Directors and secretaries are extracted from the Entity Profile Report PDF using AI parsing, not from a structured API endpoint. |
| Registration number is numeric | Jersey registration numbers are 4-7 digit numeric identifiers (e.g., 116051), unlike Guernsey which uses prefixed identifiers. |
| Documents cached 24 hours | Entity Profile Reports are cached for 24 hours after retrieval to avoid redundant purchases. |
| Capital in GBP | Jersey companies report share capital in British Pounds Sterling (GBP), not Euros. |
| Cloudflare-protected checkout | The JFSC document purchase uses Cloudflare Turnstile protection. The system handles this automatically. |
| No UBOs | Ultimate Beneficial Owner data is not available through the JFSC Registry. |
| No establishments | The JFSC does not provide establishment/branch data. |