> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Jersey
> Country-specific identifiers, data sources, and implementation details
## Start here
This guide contains public integration notes for Jersey. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
## 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, retrieved 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 retrieve through the JFSC online checkout.
The JFSC Registry Search API provides only basic company data. Detailed attributes (directors, shareholders, capital, address) require retrieving and AI-parsing the Entity Profile Report PDF. The report is automatically retrieved when a full company profile is requested.
The Entity Profile Report is obtained through a multi-step automated process:
1. **Automated Retrieval**: The system navigates the JFSC checkout flow to retrieve the document
2. **Protected register access**: The register uses additional browser-side protection; Topograph handles this automatically.
3. **Email Delivery**: The document is delivered via email (typically within 1 minute)
4. **Download**: The PDF is downloaded from the time-limited email link (valid 14 days)
5. **Storage**: The document is deduplicated for 24 hours
6. **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 |
**Registration Number Format:** Jersey registration numbers are purely numeric identifiers of 4 to 7 digits (e.g., `495`, `116051`). Unlike Guernsey, which uses prefixed identifiers, Jersey numbers have no letter prefix.
### Identifiers in API Response
Once you retrieve company data, the `identifiers` 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 Performance:** Use registration number searches for best performance and exact matching. Name searches include previous names by default and may return many results across all entity types.
**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.
**Wholly-Owned Subsidiary Pattern:** Many Jersey companies have only 1 share issued despite higher authorized capital. A single shareholder holding 1 share is correctly interpreted as 100% ownership.
## 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 |
**Legend:** ✅ Available | ❌ Not Available | ⚠️ Conditionally Available | Sync = Synchronous | Async = Asynchronous
## Documents by Company Type
### All Entity Types
| Document Type | API Category | Format | Catalog item | Availability | Notes |
| --------------------------------------- | ---------------------- | ------ | ---------------------------- | ---------------------- | ----------------------------------------- |
| **Entity Profile Report (Uncertified)** | `tradeRegisterExtract` | PDF | `jey-trade-register-extract` | ✅ Active entities only | Official JFSC company registration report |
**Entity Profile Report Availability:** The Entity Profile Report is **only available for active entities**. Dissolved, Struck Off, Cancelled, Wound Up, and Removed entities cannot have their Entity Profile Report retrieved from the JFSC. For inactive entities, only basic data from the search API is returned.
**Document Caching:** Entity Profile Reports are deduplicated for 24 hours after retrieval to avoid redundant retrieves. Subsequent requests within 24 hours return the deduplicated version.
## Example API Responses
All examples use **placeholder data**. Query: `POST /v2/company` with `{ "id": "", "countryCode": "JE", "dataPoints": ["company", "legalRepresentatives"] }`
```json theme={null}
{
"company": {
"id": "123456",
"countryCode": "JE",
"identifiers": {
"registrationNumber": "123456"
},
"legalName": "EXAMPLE HOLDINGS (JERSEY) LIMITED",
"legalNameInEnglish": "EXAMPLE HOLDINGS (JERSEY) LIMITED",
"registrationDate": "2018-03-15",
"status": {
"localName": "Active",
"active": true,
"statusDetails": {
"status": "ACTIVE"
}
},
"legalForm": {
"localName": "Registered Company Private",
"englishTranslation": "Private Limited Company",
"standardized": "Limited Liability Company",
"iso20275Code": "SQXV"
},
"capital": {
"amount": 10000,
"currency": "GBP",
"formatted": "\u00a310,000"
},
"legalAddress": {
"addressLine1": "47 Esplanade",
"city": "St. Helier",
"postalCode": "JE1 0BD",
"countryCode": "JE"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": {
"localName": "Director",
"englishTranslation": "Director",
"standardized": "Director"
},
"individual": {
"name": {
"fullName": "Jane Elizabeth Smith",
"firstName": "Jane Elizabeth",
"lastName": "Smith"
},
"birthDate": {
"month": 6,
"year": 1980
},
"nationality": "GB",
"residenceAddress": {
"addressLine1": "47 Esplanade",
"city": "St. Helier",
"region": "Jersey",
"postalCode": "JE1 0BD",
"countryCode": "JE"
}
}
},
{
"type": "individual",
"role": {
"localName": "Director",
"englishTranslation": "Director",
"standardized": "Director"
},
"individual": {
"name": {
"fullName": "John Robert Doe",
"firstName": "John Robert",
"lastName": "Doe"
},
"birthDate": {
"month": 10,
"year": 1975
},
"nationality": "GB",
"residenceAddress": {
"addressLine1": "47 Esplanade",
"city": "St. Helier",
"region": "Jersey",
"postalCode": "JE1 0BD",
"countryCode": "JE"
}
}
}
],
"shareholders": [
{
"type": "company",
"sharePercentage": 100,
"numberOfShares": 1,
"source": "Members section",
"company": {
"legalName": "PARENT GROUP LIMITED",
"countryCode": "JE",
"legalAddress": {
"addressLine1": "47 Esplanade",
"city": "St. Helier",
"postalCode": "JE1 0BD",
"countryCode": "JE"
}
}
}
]
}
```
```json theme={null}
{
"company": {
"id": "495",
"countryCode": "JE",
"identifiers": {
"registrationNumber": "495"
},
"legalName": "EXAMPLE PARTNERS L.P.",
"registrationDate": "2004-03-31",
"status": {
"localName": "Cancelled",
"active": false,
"statusDetails": {
"status": "CLOSED",
"closureReason": "VOLUNTARY_DISSOLUTION"
}
},
"legalForm": {
"localName": "Limited Partnership",
"englishTranslation": "Limited Partnership",
"standardized": "Partnership",
"iso20275Code": "UBWU"
}
}
}
```
**Note:** Inactive companies return only basic data (name, status, legal form, registration date). No legal representatives, shareholders, address, or capital -- the Entity Profile Report is not available for inactive entities.
Documents are returned when `"dataPoints": ["availableDocuments"]` is requested.
| API Category | Document | Notes |
| ---------------------- | ----------------------------------- | ------------------------------------------ |
| `tradeRegisterExtract` | Entity Profile Report (Uncertified) | Active entities only; \~60 second delivery |
```json theme={null}
{
"availableDocuments": [
{
"id": "b903c3b8-e0a6-5880-923f-306c10722b15",
"name": "Entity Profile Report - Uncertified Online",
"type": "trade_register_extract",
"format": "pdf",
"description": "Jersey FSC Entity Profile Report (uncertified)",
"estimatedDeliverySeconds": 60
}
]
}
```
All documents are **PDF** format in **English**.
## 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 retrieved 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 deduplicated 24 hours** | Entity Profile Reports are deduplicated for 24 hours after retrieval to avoid redundant retrieves. |
| **Capital in GBP** | Jersey companies report share capital in British Pounds Sterling (GBP), not Euros. |
| **Protected document retrieval** | The JFSC document retrieval flow uses additional browser-side protection. Topograph 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. |