> ## 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.

# Guernsey

> Country-specific identifiers, data sources, and implementation details

## Start here

This guide contains public integration notes for Guernsey. 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.

<Card title="Guernsey coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/gg">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Note>
  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.
</Note>

## Table of Contents

* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Data Availability](#data-availability)
* [Example API Responses](#example-api-responses)

## Data Sources

Guernsey uses a single official registry for all entity types. Data comes from the **Guernsey Registry** -- there is no cross-registry merging.

### Commercial companies, partnerships & foundations

* **Guernsey Registry** -- Operated by the Guernsey Financial Services Commission (GFSC) under the Companies (Guernsey) Law, 2008. The Registry Portal at `portal.guernseyregistry.com` provides a public API covering companies (Non-Cellular, Protected Cell, Incorporated Cell), Limited Partnerships, Limited Liability Partnerships, and Foundations. This is the **sole source** for all structured entity data: company name, legal form, status, incorporation date, registered address, economic activity, directors, and other officials.

### Charities & non-profits

* **Guernsey Registry** -- Charities and Non-Profit Organisations are registered through the same Registry Portal under the Charities and Non Profit Organisations (Registration) (Guernsey) Law, 2008. The API exposes the same endpoints for these entity types, including officer data (Chairperson, Treasurer, Secretary) and available documents.

<Note>
  All Guernsey Registry data is publicly available without authentication. The API has a rate limit of **60 requests per minute**.
</Note>

<AccordionGroup>
  <Accordion title="How does the data flow work?">
    For each company profile request, the system aggregates data from **five** Guernsey Registry API endpoints in parallel:

    1. **Public Search** -- Basic company data (name, status, entity type, registration number)
    2. **Entity Details** -- Registered address, registration date, contact info
    3. **Extended Details** -- Economic activity code and classification
    4. **Events** -- Filing history (used to extract incorporation date)
    5. **Name History** -- Previous/former names

    For key persons, a sixth endpoint is called:

    6. **Relationships** -- Directors, Resident Agents, General Partners, Councillors, etc.

    Address parsing uses Nominatim for standardization. Legal form is mapped deterministically from the Registry's entity type; status and activity codes are enriched using AI.
  </Accordion>
</AccordionGroup>

## Company Identifiers

### Query Identifiers

Guernsey entities are identified using a **registration number** prefixed by the entity type:

| Prefix | Entity Type                      | Format         | Example    | Notes                                            |
| ------ | -------------------------------- | -------------- | ---------- | ------------------------------------------------ |
| `CMP`  | Company (Non-Cellular, PCC, ICC) | `CMP` + digits | `CMP10001` | Most common entity type                          |
| `FND`  | Foundation                       | `FND` + digits | `FND167`   | Guernsey Foundations Law, 2012                   |
| `LLP`  | Limited Liability Partnership    | `LLP` + digits | `LLP149`   | Guernsey LLP Law, 2013                           |
| `LP`   | Limited Partnership              | `LP` + digits  | `LP2075`   | Includes variants with/without legal personality |
| `CH`   | Charity                          | `CH` + digits  | `CH12`     | International and domestic charities             |
| `NP`   | Non-Profit Organisation          | `NP` + digits  | `NP2`      | Domestic NPOs                                    |

<Warning>
  **Always use the full prefixed registration number.** The numeric part alone (e.g., `10001` instead of `CMP10001`) will not match correctly. The prefix is part of the official identifier.
</Warning>

### Identifiers in API Response

| Identifier Type      | Format          | Example    | Found In         |
| -------------------- | --------------- | ---------- | ---------------- |
| `registrationNumber` | Prefix + digits | `CMP10001` | All entity types |

<Note>
  Guernsey entities do not have VAT numbers, SIREN equivalents, or other secondary identifiers. The registration number is the only public identifier.
</Note>

## Search Capabilities

| Search Type            | Pattern         | Example                  | Match Type | Expected Results                                                     |
| ---------------------- | --------------- | ------------------------ | ---------- | -------------------------------------------------------------------- |
| By Registration Number | Prefix + digits | `CMP10001`               | Exact      | Exact match returned first (matchType: id); other results may follow |
| By Name                | Text string     | `"Barron International"` | Fuzzy      | Multiple results across all entity types                             |
| By Partial Name        | Text string     | `"Clay Target"`          | Fuzzy      | Multiple results                                                     |

<Note>
  **Search uses live Registry API lookups.** Both name and identifier searches query the Guernsey Registry's public-search endpoint in real time. Name searches accept free text with a minimum of 2 characters and a maximum of 100 characters.
</Note>

<Tip>
  Use registration number searches for exact matching and best performance. Name searches may return multiple results across different entity types (companies, charities, NPOs, foundations, partnerships).
</Tip>

## Quirks & Gotchas

| Quirk                                     | Details                                                                                                                                                                                                                              |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Prefixed registration numbers**         | Registration numbers always include a prefix (`CMP`, `FND`, `LLP`, `LP`, `CH`, `NP`). Using just the numeric part will fail.                                                                                                         |
| **No shareholders or UBO data**           | Shareholder and Ultimate Beneficial Owner data is private in Guernsey and is not available through the public register.                                                                                                              |
| **Corporate directors are common**        | Many Guernsey companies use corporate directors (trust companies acting as directors). The system uses name pattern heuristics (suffixes like "Limited", "Ltd", "LLP") to distinguish corporate from individual directors.           |
| **Compound surname handling**             | Guernsey has significant French/Norman influence, so compound surnames (Le Gallez, De Carteret, Du Feu) are common and parsed with special prefix detection for `Le`, `De`, `Du`, `Van`, etc.                                        |
| **Resident Agent on all entity types**    | Almost all Guernsey entities have a Resident Agent (typically a licensed trust company), mapped as an Other Key Person.                                                                                                              |
| **GFSC activity codes are non-standard**  | Guernsey uses its own dotted-numeric classification (e.g., `10.5.7`), not SIC or NACE. NACE and ISIC are always AI-inferred from the description text.                                                                               |
| **"NA" activity means no classification** | Some entities have `NA` as their economic activity, meaning no specific activity has been assigned. No activity codes are returned for these entities.                                                                               |
| **Charity/NPO statements are free**       | Trade Register Extracts for charities (`CH`) and non-profits (`NP`) are free, while commercial entity types (`CMP`, `LP`, `LLP`, `FND`) are paid (see [pricing](https://www.topograph.co/pricing)).                                  |
| **Uncertain relationship types need AI**  | The "Other Managing Official" role (type ID 123) is ambiguous and requires AI analysis to classify as legal representative or other key person. For charities/NPOs, these are typically trustees with collective signing authority.  |
| **\~20 distinct entity statuses**         | Guernsey has numerous status values including multiple dissolved variants (voluntary liquidation, registrar strike off, compulsory liquidation, voluntary strike off, wound up, etc.). All are AI-enriched to standardized statuses. |
| **Dissolved companies lack officials**    | Dissolved companies often return empty arrays for the relationships/officials endpoint.                                                                                                                                              |
| **Automated document retrieve**           | Paid documents require an official document retrieval flow (login, MFA, cart, checkout, 3DS verification) before download. This adds significant latency (up to 20 minutes).                                                         |
| **Rate limit: 60 requests/minute**        | The Guernsey Registry API enforces a rate limit of 60 requests per minute (`X-Rate-Limit-Limit: 1m`).                                                                                                                                |
| **No financial statements**               | Guernsey companies do not file financial statements publicly. "Annual Validation" and "Annual Return" documents are compliance filings, not financial statements.                                                                    |

## Statutory Filings

Guernsey companies file an **annual validation**, the local equivalent of a confirmation statement, confirming the entity's particulars are current. The Registry publishes the date it next falls due, returned on the cross-country `statutoryFilings` field.

```json theme={null}
{
  "statutoryFilings": {
    "annualFiling": {
      "cadence": "annual",
      "next": { "dueDate": "2026-06-30" },
      "source": "guernsey_registry"
    }
  }
}
```

The Registry exposes no "last filed" date, so only `next.dueDate` is populated. Guernsey companies file no public financial statements, so there is no `accounts` obligation to report.

See [Compliance Signals & Statutory Filings](/essentials/compliance-signals) for the full field reference.

## Mappings

### Company Status

Company status is extracted from the Guernsey Registry's `entityStatusDesc` field. The `active` flag is determined deterministically from a known list of active statuses. The standardized status (`statusDetails`) is **AI-enriched**.

#### Active Statuses

| Local Status | Standardized Status | Notes                                                              |
| ------------ | ------------------- | ------------------------------------------------------------------ |
| Normal       | Active              | Standard operating status for companies, partnerships, foundations |
| Registered   | Active              | Standard status for charities and NPOs                             |
| Current      | Active              | Used for trademarks and patents                                    |

#### At-Risk Statuses

| Local Status                     | Standardized Status         | Notes                                                                    |
| -------------------------------- | --------------------------- | ------------------------------------------------------------------------ |
| In Default                       | Under Insolvency Proceeding | Entity has failed to meet filing obligations or is in financial distress |
| Strike Off Listed                | Under Insolvency Proceeding | Entity has been listed for strike-off by the Registrar                   |
| Voluntary strike off application | Under Insolvency Proceeding | Entity has applied for voluntary strike-off                              |

#### Winding Up Statuses

| Local Status                                           | Standardized Status         | Notes                                                   |
| ------------------------------------------------------ | --------------------------- | ------------------------------------------------------- |
| Voluntary winding up Part 1 (liquidator appointed)     | Under Insolvency Proceeding | Voluntary dissolution in progress, liquidator appointed |
| Voluntary winding up Part 2 (liquidator final meeting) | Under Insolvency Proceeding | Final stage of voluntary winding up                     |
| Compulsory winding up Part 1 (liquidator appointed)    | Under Insolvency Proceeding | Court-ordered winding up, liquidator appointed          |
| Compulsorily Wound Up                                  | Closed                      | Company wound up by court order                         |
| Wound Up                                               | Closed                      | Company has completed winding up process                |

#### Inactive / Closed Statuses

| Local Status | Standardized Status | Notes                                         |
| ------------ | ------------------- | --------------------------------------------- |
| Ceased       | Closed              | Entity has ceased operations                  |
| Converted    | Closed              | Entity converted to another form              |
| Amalgamated  | Closed              | Entity merged with another entity             |
| Migrated     | Closed              | Entity migrated to another jurisdiction       |
| Struck Off   | Closed              | Entity removed from the register              |
| Expired      | Closed              | Used for trademarks/patents that have expired |
| Historic     | Closed              | Used for trademarks/patents no longer current |

#### Dissolved Statuses

| Local Status                                | Standardized Status | Notes                                                  |
| ------------------------------------------- | ------------------- | ------------------------------------------------------ |
| Dissolved                                   | Closed              | Generic dissolved status                               |
| Dissolved (voluntary liquidation)           | Closed              | Dissolved after voluntary liquidation                  |
| Dissolved (voluntary strike off)            | Closed              | Dissolved after voluntary strike off                   |
| Dissolved (registrar compulsory strike off) | Closed              | Dissolved by Registrar compulsory action               |
| Dissolved (compulsory liquidation)          | Closed              | Dissolved after compulsory (court-ordered) liquidation |
| Dissolved (wound up)                        | Closed              | Dissolved after winding up process                     |

### Legal Forms

Guernsey uses entity type IDs from the Registry API. The entity type set is closed and statutory, so the local name, English name, standardized category and ISO 20275 (ELF) code are all mapped deterministically. No AI is involved in the legal form.

<Note>
  Guernsey's ISO 20275 vocabulary splits companies by liability (limited by
  shares, limited by guarantee, mixed liability, unlimited), and each carries a
  different ELF code. The Registry does not publish which of those a given
  company is, so no ISO 20275 code is returned for the generic company types
  rather than an inferred one.
</Note>

#### Companies

| Local Name                      | English Translation             | Standardized              | ISO 20275     |
| ------------------------------- | ------------------------------- | ------------------------- | ------------- |
| Non Cellular Company            | Non Cellular Company            | Limited Liability Company | not published |
| Protected Cell Company (PCC)    | Protected Cell Company (PCC)    | Limited Liability Company | 4C0J          |
| Incorporated Cell Company (ICC) | Incorporated Cell Company (ICC) | Limited Liability Company | QJBA          |
| Incorporated Cell               | Incorporated Cell               | Limited Liability Company | 2AUN          |

#### Partnerships

| Local Name                                                         | English Translation                                                | Standardized | ISO 20275 |
| ------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------ | --------- |
| Limited Partnership                                                | Limited Partnership                                                | Partnership  | UO3D      |
| Limited Partnership (no separate legal personality)                | Limited Partnership (no separate legal personality)                | Partnership  | 75XK      |
| Incorporated Limited Partnership (with separate legal personality) | Incorporated Limited Partnership (with separate legal personality) | Partnership  | MCQP      |
| Limited Liability Partnership (LLP)                                | Limited Liability Partnership (LLP)                                | Partnership  | Q49K      |

#### Foundations & Non-Profits

| Local Name                                                   | English Translation                                          | Standardized           | ISO 20275     |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ---------------------- | ------------- |
| Foundation                                                   | Foundation                                                   | Nonprofit Organization | 9XFK          |
| Non-Profit Organisation (Domestic - compulsorily registered) | Non-Profit Organisation (Domestic - compulsorily registered) | Nonprofit Organization | not published |
| Non-Profit Organisation (Domestic - voluntarily registered)  | Non-Profit Organisation (Domestic - voluntarily registered)  | Nonprofit Organization | not published |

#### Charities

| Local Name                                          | English Translation                                 | Standardized           | ISO 20275     |
| --------------------------------------------------- | --------------------------------------------------- | ---------------------- | ------------- |
| Charity (Domestic - compulsorily registered)        | Charity (Domestic - compulsorily registered)        | Nonprofit Organization | not published |
| Charity (Domestic - voluntarily registered)         | Charity (Domestic - voluntarily registered)         | Nonprofit Organization | not published |
| Charity (International - compulsorily registered)   | Charity (International - compulsorily registered)   | Nonprofit Organization | not published |
| Charity (Branch of British registered organisation) | Charity (Branch of British registered organisation) | Nonprofit Organization | not published |

#### Other Entity Types (not company profiles)

| Local Name                  | English Translation         | Standardized | ISO 20275 |
| --------------------------- | --------------------------- | ------------ | --------- |
| Trademark (Word only)       | Trademark (Word only)       | --           | --        |
| Trademark (Stylised word)   | Trademark (Stylised word)   | --           | --        |
| Trademark (Device and word) | Trademark (Device and word) | --           | --        |
| Patent                      | Patent                      | --           | --        |

<Note>
  The local legal form name from the Registry is always preserved verbatim.
</Note>

### Legal Representatives

Legal representatives are extracted from the Guernsey Registry's relationships endpoint. Classification is **deterministic** for known relationship types (no AI needed). Both individuals and corporate entities can hold legal representative roles.

| Local Role Name | English Translation | Standardized     | Entity Types         | Notes                                                  |
| --------------- | ------------------- | ---------------- | -------------------- | ------------------------------------------------------ |
| Director        | Director            | Director         | Companies, Charities | Can be individual or corporate (mixed)                 |
| General Partner | General Partner     | General Partner  | Limited Partnerships | Can be individual or corporate (mixed)                 |
| Chairperson     | Chairperson         | Chairman         | NPOs, Charities      | Always individual                                      |
| Councillor      | Councillor          | Director         | Foundations          | Can be individual or corporate; equivalent to director |
| Member          | Member              | Managing Partner | LLPs                 | Can be individual or corporate (mixed)                 |
| Guardian        | Guardian            | Other            | Foundations          | Can be individual or corporate; oversight role         |

### Other Key Persons

| Local Role Name | English Translation | Standardized | Entity Types     | Notes                                                                        |
| --------------- | ------------------- | ------------ | ---------------- | ---------------------------------------------------------------------------- |
| Resident Agent  | Resident Agent      | Other        | All entity types | Typically a licensed trust/fiduciary company; can be individual or corporate |
| Secretary       | Secretary           | Secretary    | Companies        | Always individual                                                            |
| Treasurer       | Treasurer           | Other        | NPOs, Charities  | Always individual                                                            |

<Info>
  **Uncertain Roles (AI-parsed):** The "Other Managing Official" role (relationship type ID 123, always individual) is ambiguous. For charities/NPOs, these are typically trustees with collective signing authority and are classified as Legal Representatives by AI. For companies, they are usually classified as Other Key Persons unless they have explicit signing authority.
</Info>

#### Structural Relationships (excluded from key persons)

The following relationship types appear in the API but are **not** mapped to key persons:

| Local Role Name         | English Translation     | Notes                                        |
| ----------------------- | ----------------------- | -------------------------------------------- |
| Incorporated Cell       | Incorporated Cell       | Cells within ICCs -- structural relationship |
| Related Guernsey Entity | Related Guernsey Entity | Cross-entity relationships -- structural     |

### Shareholders

<Warning>
  **No shareholder data available.** Shareholder and ownership information is private in Guernsey and is not disclosed through the public Registry. Neither ownership percentages nor beneficial ownership data is available.
</Warning>

### Activity Code Mapping

Guernsey uses its own **GFSC economic activity classification** with dotted numeric codes (e.g., `10.5.7`, `02.9.1`). These codes do not directly map to European or international standards. NACE and ISIC codes are **always AI-inferred** from the activity description text.

```
GFSC Activity Code (local) --> AI-inferred NACE (European) --> AI-inferred ISIC (International)
```

| Classification | Source                             | Example  | AI Inferred?  |
| -------------- | ---------------------------------- | -------- | ------------- |
| **GFSC**       | Guernsey Registry extended details | `10.5.7` | No (official) |
| **NACE**       | AI-inferred from GFSC description  | `64.21`  | Yes (always)  |
| **ISIC**       | AI-inferred from GFSC description  | `6420`   | Yes (always)  |

<Note>
  Some entities have `NA` as their economic activity classification, indicating no specific activity has been assigned. In these cases, no activity codes are returned. Both NACE and ISIC codes are **always AI-inferred** for Guernsey entities -- check the `isAIInferred` flag.
</Note>

## Data Availability

### Data Availability Matrix

| Data Type                  | Availability | Notes                                                                            |
| -------------------------- | ------------ | -------------------------------------------------------------------------------- |
| Company Profile            | ✅ Async      | Name, status, legal form, incorporation date, registered address, previous names |
| Legal Representatives      | ✅ Async      | Directors, Councillors, Members, General Partners, Chairpersons, Guardians       |
| Other Key Persons          | ✅ Async      | Resident Agents, Secretaries, Treasurers                                         |
| Shareholders               | ❌            | Private information -- not available through public register                     |
| Ultimate Beneficial Owners | ❌            | Private information -- not available through public register                     |
| Activity Codes             | ✅            | GFSC codes (official); NACE/ISIC (AI-inferred)                                   |
| Establishments             | ❌            | Not applicable -- Guernsey entities register a single registered office          |
| Documents                  | ✅ Async      | Statements of Register, certificates, articles, filings                          |

**Legend:** ✅ Available | ❌ Not Available | Async = Asynchronous processing

### Documents by Company Type

| Entity Type                | Trade Register Extract           | Certificate of Good Standing | Certificate of Incorporation | Articles of Association | Other Filed Documents           | Statement of Register                                  |
| -------------------------- | -------------------------------- | ---------------------------- | ---------------------------- | ----------------------- | ------------------------------- | ------------------------------------------------------ |
| Company (`CMP`)            | Company Statement of Register    | ✅                            | ✅                            | ✅                       | Annual Validations, Resolutions | Paid (see [pricing](https://www.topograph.co/pricing)) |
| Limited Partnership (`LP`) | LP Statement of Register         | ✅                            | ❌                            | ❌                       | Annual Validations              | Paid (see [pricing](https://www.topograph.co/pricing)) |
| LLP (`LLP`)                | LLP Statement of Register        | ✅                            | ✅                            | ❌                       | Governance, Resolutions         | Paid (see [pricing](https://www.topograph.co/pricing)) |
| Foundation (`FND`)         | Foundation Statement of Register | ✅                            | ✅                            | ❌                       | Governance                      | Paid (see [pricing](https://www.topograph.co/pricing)) |
| Charity (`CH`)             | Charity Statements               | ❌                            | ❌                            | ❌                       | Varies                          | Free                                                   |
| Non-Profit (`NP`)          | NPO Statements                   | ❌                            | ❌                            | ❌                       | Varies                          | Free                                                   |

<Info>
  **Document catalog items:**

  * `GGY_TRADE_REGISTER_EXTRACT` -- Paid Statement of Register for commercial entities (CMP, LP, LLP, FND)
  * `GGY_TRADE_REGISTER_EXTRACT_CHARITY_NONPROFIT` -- Free Statement for charities/NPOs
  * `GGY_CERTIFICATE_OF_GOOD_STANDING` -- Certificate of Good Standing (active entities only)
  * `GGY_CERTIFICATE_OF_INCORPORATION` -- Historical certificate of incorporation
  * `GGY_ARTICLE_OF_ASSOCIATION` -- Articles/Memorandum of Association
  * `GGY_FILED_DOCUMENT` -- All other filed documents (Annual Validations, Resolutions, etc.)
</Info>

<Warning>
  **Certificate of Good Standing** is only available for entities with an active status (`Normal`, `Registered`). Dissolved, wound up, or struck off entities cannot obtain this certificate.
</Warning>

### Example API Responses

All examples use **placeholder data**. Query: `POST /v2/company` with `{ "id": "<id>", "countryCode": "GG", "dataPoints": ["company", "legalRepresentatives"] }`

<AccordionGroup>
  <Accordion title="Active Non-Cellular Company with Corporate Directors (CMP)">
    ```json theme={null}
    {
      "company": {
        "id": "CMP10001",
        "countryCode": "GG",
        "identifiers": { "registrationNumber": "CMP10001" },
        "legalName": "EXAMPLE HOLDINGS LIMITED",
        "incorporationDate": "2010-05-20",
        "activityDescription": "Other holding company not directly engaged in trading or other active income generating activities",
        "status": {
          "localName": "Normal",
          "active": true,
          "statusDetails": { "status": "ACTIVE", "additionalInfo": "" }
        },
        "legalForm": {
          "localName": "Non Cellular Company",
          "englishTranslation": "Non Cellular Company",
          "standardized": "Limited Liability Company"
        },
        "activities": {
          "items": [{ "code": "10.5.7", "description": "Other holding company not directly engaged in trading or other active income generating activities" }],
          "NACE": [{ "code": "64.21", "description": "Activities of holding companies", "isAIInferred": true }],
          "ISIC": [{ "code": "6420", "description": "Activities of holding companies", "isAIInferred": true }]
        },
        "legalAddress": { "addressLine1": "PO Box 296, Regency Court", "addressLine2": "Glategny Esplanade", "city": "St Peter Port", "postalCode": "GY1 4NA", "countryCode": "GG" }
      },
      "legalRepresentatives": [
        {
          "entityId": "gg-rel-51767",
          "type": "company",
          "startDate": "2008-07-09",
          "role": { "localName": "Director", "englishTranslation": "Director", "standardized": "Director" },
          "company": { "id": "CMP20002", "countryCode": "GG", "legalName": "CORPORATE DIRECTORS LIMITED", "identifiers": { "entityId": "100216", "registrationNumber": "CMP20002" }, "legalForm": { "localName": "Non Cellular Company" }, "status": { "localName": "Normal", "active": true } }
        },
        {
          "entityId": "gg-rel-51768",
          "type": "company",
          "startDate": "2008-07-09",
          "role": { "localName": "Director", "englishTranslation": "Director", "standardized": "Director" },
          "company": { "id": "CMP30003", "countryCode": "GG", "legalName": "TRUST SERVICES LIMITED", "identifiers": { "entityId": "83202", "registrationNumber": "CMP30003" } }
        }
      ],
      "otherKeyPersons": [
        {
          "type": "company",
          "startDate": "2008-07-09",
          "role": { "localName": "Resident Agent", "englishTranslation": "Resident Agent", "standardized": "Other" },
          "company": { "id": "CMP40004", "countryCode": "GG", "legalName": "FIDUCIARY TRUST COMPANY LIMITED", "identifiers": { "entityId": "83127", "registrationNumber": "CMP40004" } }
        }
      ]
    }
    ```

    **Note:** Corporate directors are enriched with additional company data (registration number, legal form, status, address) via a secondary entity lookup. This is a common pattern in Guernsey where trust companies act as directors.
  </Accordion>

  <Accordion title="Dissolved Company with Previous Names (CMP)">
    ```json theme={null}
    {
      "company": {
        "id": "CMP5119",
        "countryCode": "GG",
        "identifiers": { "registrationNumber": "CMP5119" },
        "legalName": "EXAMPLE INSURANCE LIMITED",
        "activityDescription": "Trusts, companies and other structures administered by fiduciaries",
        "legacyLegalNames": ["FORMER INSURANCE LTD.", "OLD TRADING NAME LTD."],
        "status": {
          "localName": "Wound Up",
          "active": false,
          "statusDetails": { "status": "CLOSED", "closureReason": "VOLUNTARY_DISSOLUTION", "additionalInfo": "The term 'Wound Up' typically indicates that the company has been dissolved or liquidated voluntarily." }
        },
        "legalForm": {
          "localName": "Non Cellular Company",
          "englishTranslation": "Non Cellular Company",
          "standardized": "Limited Liability Company"
        },
        "activities": {
          "items": [{ "code": "10.2.1", "description": "Trusts, companies and other structures administered by fiduciaries" }],
          "NACE": [{ "code": "64.21", "description": "Activities of holding companies", "isAIInferred": true }],
          "ISIC": [{ "code": "6420", "description": "Activities of holding companies", "isAIInferred": true }]
        },
        "legalAddress": { "addressLine1": "Le Bordage Rd", "city": "St Sampson", "postalCode": "GY2", "countryCode": "GG" }
      }
    }
    ```

    **Note:** Dissolved companies include `legacyLegalNames` when previous names exist. Officials data is typically empty for dissolved entities.
  </Accordion>

  <Accordion title="Foundation with Councillors and Guardian (FND)">
    ```json theme={null}
    {
      "company": {
        "id": "FND167",
        "countryCode": "GG",
        "identifiers": { "registrationNumber": "FND167" },
        "legalName": "THE EXAMPLE FAMILY FOUNDATION",
        "activityDescription": "Trusts and other similar structures (that are not companies)",
        "status": {
          "localName": "Voluntary winding up Part 1 (liquidator appointed)",
          "active": false,
          "statusDetails": { "status": "UNDER_INSOLVENCY_PROCEEDING", "closureReason": "VOLUNTARY_DISSOLUTION", "additionalInfo": "Voluntary winding up with liquidator appointed indicates insolvency proceeding under voluntary dissolution." }
        },
        "legalForm": {
          "localName": "Foundation",
          "englishTranslation": "Foundation",
          "standardized": "Nonprofit Organization",
          "iso20275Code": "9XFK"
        },
        "activities": {
          "items": [{ "code": "10.7.1", "description": "Trusts and other similar structures (that are not companies)" }],
          "NACE": [{ "code": "64.3", "description": "Trusts, funds and similar financial entities", "isAIInferred": true }],
          "ISIC": [{ "code": "6430", "description": "Trusts, funds and similar financial entities", "isAIInferred": true }]
        },
        "legalAddress": { "city": "St Pierre Du Bois", "countryCode": "GG" }
      },
      "legalRepresentatives": [
        {
          "entityId": "gg-rel-340353",
          "type": "company",
          "startDate": "2024-04-23",
          "role": { "localName": "Councillor", "englishTranslation": "Councillor", "standardized": "Director" },
          "company": { "id": "CMP50005", "countryCode": "GG", "legalName": "FAMILY OFFICE LIMITED", "identifiers": { "entityId": "127243", "registrationNumber": "CMP50005" } }
        },
        {
          "entityId": "gg-rel-340354",
          "type": "individual",
          "startDate": "2024-04-23",
          "role": { "localName": "Councillor", "englishTranslation": "Councillor", "standardized": "Director" },
          "individual": { "name": { "fullName": "John Andrew Smith", "firstName": "John", "lastName": "Smith" } }
        },
        {
          "entityId": "gg-rel-340355",
          "type": "individual",
          "startDate": "2024-04-23",
          "role": { "localName": "Councillor", "englishTranslation": "Councillor", "standardized": "Director" },
          "individual": { "name": { "fullName": "James Peter Brown", "firstName": "James", "lastName": "Brown" } }
        },
        {
          "entityId": "gg-rel-340356",
          "type": "individual",
          "startDate": "2024-04-23",
          "role": { "localName": "Guardian", "englishTranslation": "Guardian", "standardized": "Other" },
          "individual": { "name": { "fullName": "Robert David Wilson", "firstName": "Robert", "lastName": "Wilson" } }
        }
      ],
      "otherKeyPersons": [
        {
          "type": "company",
          "startDate": "2024-04-23",
          "role": { "localName": "Resident Agent", "englishTranslation": "Resident Agent", "standardized": "Other" },
          "company": { "id": "CMP50005", "countryCode": "GG", "legalName": "FAMILY OFFICE LIMITED", "identifiers": { "entityId": "127243", "registrationNumber": "CMP50005" } }
        }
      ]
    }
    ```

    **Note:** Foundations use "Councillor" as the legal representative role (equivalent to directors for governance). The "Guardian" role is also a legal representative with oversight authority. Resident Agent is always classified as Other Key Person.
  </Accordion>

  <Accordion title="Non-Profit Organisation with Chairperson, Treasurer, Secretary (NP)">
    ```json theme={null}
    {
      "company": {
        "id": "NP2",
        "countryCode": "GG",
        "identifiers": { "registrationNumber": "NP2" },
        "legalName": "THE EXAMPLE SPORTS CLUB LBG",
        "status": {
          "localName": "Normal",
          "active": true,
          "statusDetails": { "status": "ACTIVE", "additionalInfo": "" }
        },
        "legalForm": {
          "localName": "Non-Profit Organisation (Domestic - compulsorily registered)",
          "englishTranslation": "Non-Profit Organisation (Domestic - Compulsorily Registered)",
          "standardized": "Nonprofit Organization"
        },
        "legalAddress": { "addressLine1": "63 Example Street", "city": "St Peter Port", "postalCode": "GY1", "countryCode": "GG" }
      },
      "legalRepresentatives": [
        {
          "entityId": "gg-rel-344311",
          "type": "individual",
          "startDate": "2024-07-25",
          "role": { "localName": "Chairperson", "englishTranslation": "Chairperson", "standardized": "Chairman" },
          "individual": { "name": { "fullName": "Michael James Green", "firstName": "Michael", "lastName": "Green" } }
        }
      ],
      "otherKeyPersons": [
        {
          "type": "individual",
          "startDate": "2024-07-25",
          "role": { "localName": "Treasurer", "englishTranslation": "Treasurer", "standardized": "Other" },
          "individual": { "name": { "fullName": "Pierre Le Gallez", "firstName": "Pierre", "lastName": "Le Gallez" } }
        },
        {
          "type": "individual",
          "startDate": "2024-07-25",
          "role": { "localName": "Secretary", "englishTranslation": "Secretary", "standardized": "Secretary" },
          "individual": { "name": { "fullName": "Thomas Robert Taylor", "firstName": "Thomas", "lastName": "Taylor" } }
        }
      ]
    }
    ```

    **Note:** Non-profits have a Chairperson as the primary legal representative, with Treasurer and Secretary as other key persons. Note the compound surname "Le Gallez" -- common in Guernsey due to French/Norman heritage.
  </Accordion>

  <Accordion title="Charity with Corporate Director (CH)">
    ```json theme={null}
    {
      "company": {
        "id": "CH12",
        "countryCode": "GG",
        "identifiers": { "registrationNumber": "CH12" },
        "legalName": "EXAMPLE CHARITY (CHANNEL ISLANDS) LBG",
        "incorporationDate": "2023-01-05",
        "activityDescription": "Other unregulated finance activities not elsewhere classified",
        "status": {
          "localName": "In Default",
          "active": false,
          "statusDetails": { "status": "UNDER_INSOLVENCY_PROCEEDING", "closureReason": "UNKNOWN", "additionalInfo": "Local status 'In Default' indicates financial distress, likely insolvency proceeding." }
        },
        "legalForm": {
          "localName": "Charity (International - compulsorily registered)",
          "englishTranslation": "Charity (International - compulsorily registered)",
          "standardized": "Nonprofit Organization"
        },
        "activities": {
          "items": [{ "code": "10.9.3", "description": "Other unregulated finance activities not elsewhere classified" }],
          "NACE": [{ "code": "64.9", "description": "Other financial service activities, except insurance and pension funding activities, n.e.c.", "isAIInferred": true }],
          "ISIC": [{ "code": "6499", "description": "Other financial service activities, except insurance and pension funding activities, n.e.c.", "isAIInferred": true }]
        },
        "legalAddress": { "addressLine1": "Havilland Street", "city": "St Peter Port", "postalCode": "GY1 2QE", "countryCode": "GG" }
      },
      "legalRepresentatives": [
        {
          "entityId": "gg-rel-316943",
          "type": "company",
          "startDate": "2023-01-05",
          "role": { "localName": "Director", "englishTranslation": "Director", "standardized": "Director" },
          "company": { "id": "CMP60006", "countryCode": "GG", "legalName": "CORPORATE DIRECTORS LIMITED", "identifiers": { "entityId": "108089", "registrationNumber": "CMP60006" } }
        }
      ],
      "otherKeyPersons": [
        {
          "type": "company",
          "startDate": "2023-01-05",
          "role": { "localName": "Resident Agent", "englishTranslation": "Resident Agent", "standardized": "Other" },
          "company": { "id": "CMP70007", "countryCode": "GG", "legalName": "TRUST COMPANY LIMITED", "identifiers": { "entityId": "107990", "registrationNumber": "CMP70007" } }
        }
      ]
    }
    ```

    **Note:** Charities can have corporate directors (Director role) even though they are non-profit entities. The "In Default" status indicates the entity has failed to meet filing obligations.
  </Accordion>

  <Accordion title="Available Documents (Company example)">
    Documents are returned when `"dataPoints": ["availableDocuments"]` is requested.

    **Commercial entities (CMP, LP, LLP, FND):**

    | API Category                 | Document                              | Cost                                                   | Notes                                      |
    | ---------------------------- | ------------------------------------- | ------------------------------------------------------ | ------------------------------------------ |
    | `tradeRegisterExtract`       | Statement of Register                 | Paid (see [pricing](https://www.topograph.co/pricing)) | Current company details, officers, address |
    | `certificateOfGoodStanding`  | Certificate of Good Standing          | Paid (see [pricing](https://www.topograph.co/pricing)) | Active entities only                       |
    | `certificateOfIncorporation` | Incorporation Certificate             | Free                                                   | Historical document                        |
    | `articlesOfAssociation[]`    | Articles/Memorandum of Association    | Free                                                   | Constitutional documents                   |
    | `otherDocuments[]`           | Annual Validations, Resolutions, etc. | Free                                                   | Historical filed documents                 |

    **Charities and Non-Profits (CH, NP):**

    | API Category           | Document              | Cost | Notes                  |
    | ---------------------- | --------------------- | ---- | ---------------------- |
    | `tradeRegisterExtract` | Charity/NPO Statement | Free | Registration statement |
    | `otherDocuments[]`     | Filed documents       | Free | Varies by entity       |
  </Accordion>
</AccordionGroup>