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

# Isle of Man

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

## Start here

This guide contains public integration notes for the Isle of Man. 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="Isle of Man coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/im">
  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

The Isle of Man uses a single official register for every entity type. All data comes live from the **Isle of Man Companies Registry**, and there is no cross-register merging.

### Companies, foundations, business names and foreign companies

* **Isle of Man Companies Registry**: maintained by the Isle of Man Government. It holds the register of companies incorporated under the Companies Act 1931 and the Companies Act 2006, limited liability companies, foundations, registered business names, and foreign companies. It is the **sole source** for the company profile (name, registration number, legal form, status, incorporation date, registered office address), for search, and for documents.

<Note>
  **Same answer in both modes.** Onboarding (`mode: "onboarding"`) and verification (`mode: "verification"`) requests read the same live register page and return the same `company` data.
</Note>

## Company Identifiers

### Query Identifiers

Isle of Man entities are identified by their **company number**: 6 digits followed by a letter suffix. The suffix tells you which register the entity belongs to.

| Suffix | Registry Type             | Format         | Example   |
| ------ | ------------------------- | -------------- | --------- |
| `C`    | 1931 Act Company          | 6 digits + `C` | `012345C` |
| `V`    | 2006 Act Company          | 6 digits + `V` | `001234V` |
| `B`    | Business Name             | 6 digits + `B` | `023456B` |
| `F`    | Foreign Company           | 6 digits + `F` | `003456F` |
| `L`    | Limited Liability Company | 6 digits + `L` | `000567L` |
| `M`    | Foundation                | 6 digits + `M` | `000345M` |

<Warning>
  **Send the full company number, leading zeros and suffix included** (for example `001234V`, not `1234` or `1234V`). The suffix is part of the official identifier, and the register looks the entity up by the full number.
</Warning>

### Identifiers in API Response

| Identifier           | Format                   | Example   | Found In         |
| -------------------- | ------------------------ | --------- | ---------------- |
| `registrationNumber` | 6 digits + letter suffix | `012345C` | All entity types |

<Note>
  The company number is the only identifier returned. The register does not publish VAT numbers or other secondary identifiers.
</Note>

## Search Capabilities

| Search Type       | Pattern                                                 | Example              | Match Type              | Expected Results                           |
| ----------------- | ------------------------------------------------------- | -------------------- | ----------------------- | ------------------------------------------ |
| By Company Number | 6 digits + suffix letter (`C`, `V`, `B`, `F`, `L`, `M`) | `012345C`            | Exact (`matchType: id`) | The matching entity, or none               |
| By Name           | 2 to 100 characters                                     | `"Example Holdings"` | Name match              | Multiple results across all registry types |

<Note>
  **Search uses live register lookups.** Both name and number searches query the Isle of Man Companies Registry in real time. Results carry the company number (`id`), the current legal name and the country code.
</Note>

<Tip>
  Name search matches **current names only**. A company that is known only by a former name does not appear when you search for that former name. Search by company number when you already have it.
</Tip>

## Quirks & Gotchas

| Quirk                                              | Details                                                                                                                                                                                                                                                                   |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Suffix identifies the register**                 | The trailing letter of the company number (`C`, `V`, `B`, `F`, `L`, `M`) is part of the identifier and tells you whether the entity is a 1931 Act company, a 2006 Act company, a business name, a foreign company, an LLC or a foundation.                                |
| **No officers, shareholders or beneficial owners** | The public company summary does not list directors, secretaries, shareholders or beneficial owners. Only the `company` datapoint is offered. Officer details appear in filings such as annual returns and changes in directors, which you can order as documents.         |
| **Fields vary by registry type**                   | 1931 Act and 2006 Act companies carry the most data. Business names, foundations, foreign companies and LLCs have no company type, so their legal form is the registry type. Foundations, business names and foreign companies usually have no registered office address. |
| **Incorporation date can be missing**              | The register leaves the date empty for foundations and for some very old or LLC entries. `incorporationDate` is omitted in that case.                                                                                                                                     |
| **Address returned as one line**                   | The registered office address is returned as a single `addressLine1` string, as the register publishes it. It is not split into city or postal code.                                                                                                                      |
| **Status is the register's own wording**           | `status.localName` is the register's status verbatim. `active` is `true` only for `Live`. No standardized status is returned.                                                                                                                                             |
| **No activity codes**                              | The register does not publish an activity classification, so no SIC, NACE or ISIC codes are returned.                                                                                                                                                                     |
| **Registry filings are ordered on request**        | The Trade Register Extract is generated from the live register page. Registry filings are ordered from the register when you request them, so they take longer to deliver.                                                                                                |
| **One entry per filing type**                      | The document list returns one entry for each filing type and description, not every historical copy of that filing.                                                                                                                                                       |

## Mappings

### Company Status

Status comes from the register's summary page and is returned verbatim in `status.localName`. The `active` flag is derived deterministically. No AI is involved and no `statusDetails` object is returned.

| Local Status | English Translation | `active` | Notes                                 |
| ------------ | ------------------- | -------- | ------------------------------------- |
| Live         | Live                | `true`   | Entity is on the register and current |
| Dissolved    | Dissolved           | `false`  | Used across all registry types        |
| Struck Off   | Struck Off          | `false`  | Seen on foreign companies             |
| Ceased       | Ceased              | `false`  | Seen on business names                |

<Note>
  Any other status the register publishes is passed through as-is with `active: false`.
</Note>

### Legal Forms

The legal form is returned verbatim in `legalForm.localName`. For 1931 Act and 2006 Act companies it is the register's **company type**. For every other registry type, where the register publishes no company type, it is the **registry type**. No standardized legal form or ISO 20275 code is returned.

#### Company types (1931 Act and 2006 Act companies)

| Local Name            | English Translation               | Registry Type    |
| --------------------- | --------------------------------- | ---------------- |
| Private Ltd by Shares | Private company limited by shares | 1931 Act Company |
| Public Ltd by Shares  | Public company limited by shares  | 1931 Act Company |
| Limited by shares     | Company limited by shares         | 2006 Act Company |

#### Registry types (entities without a company type)

| Local Name                | English Translation                           | Company Number Suffix |
| ------------------------- | --------------------------------------------- | --------------------- |
| Business Name             | Registered business name                      | `B`                   |
| Foreign Company           | Foreign company registered in the Isle of Man | `F`                   |
| Limited Liability Company | Limited liability company                     | `L`                   |
| Foundation                | Foundation                                    | `M`                   |

<Note>
  The company types above are the values observed on the register. A company type not listed here is still returned verbatim in `legalForm.localName`.
</Note>

## Data Availability

### Data Availability Matrix

| Data Type                   | Availability | Notes                                                                                         |
| --------------------------- | ------------ | --------------------------------------------------------------------------------------------- |
| Company Profile (`company`) | ✅            | Legal name, company number, legal form, status, incorporation date, registered office address |
| Legal Representatives       | ❌            | Directors are not published in the public company summary                                     |
| Other Key Persons           | ❌            | Secretaries and registered agents are not returned                                            |
| Shareholders                | ❌            | Not published by the register                                                                 |
| Ultimate Beneficial Owners  | ❌            | Not publicly available                                                                        |
| Activity Codes              | ❌            | Not published by the register                                                                 |
| Establishments              | ❌            | Not applicable                                                                                |
| Documents                   | ✅            | Trade Register Extract and registry filings                                                   |

**Legend:** ✅ Available | ❌ Not Available

### Documents by Company Type

| Entity Type                     | Trade Register Extract | Registry Filings                          |
| ------------------------------- | ---------------------- | ----------------------------------------- |
| 1931 Act Company (`C`)          | ✅ Company Summary      | ✅ When the register holds filed documents |
| 2006 Act Company (`V`)          | ✅ Company Summary      | ✅ When the register holds filed documents |
| Business Name (`B`)             | ✅ Company Summary      | ✅ When the register holds filed documents |
| Foreign Company (`F`)           | ✅ Company Summary      | ✅ When the register holds filed documents |
| Limited Liability Company (`L`) | ✅ Company Summary      | ✅ When the register holds filed documents |
| Foundation (`M`)                | ✅ Company Summary      | ✅ When the register holds filed documents |

* **Trade Register Extract** (`tradeRegisterExtract`): a PDF of the entity's Company Summary page on the Isle of Man Companies Registry, stamped with the time it was generated. Available for every entity.
* **Registry filings** (`otherDocuments`): documents filed with the register, such as annual returns, changes in directors or secretaries, registers of directors, and particulars of charges. Filings identified as a memorandum or articles of association are listed under `articlesOfAssociation` instead. The list depends on what the entity has filed, and some entities have none.

All documents are **PDF** format in **English**.

## Example API Responses

All examples use **placeholder data**.

### Search by Company Number

```bash theme={null}
curl "https://api.topograph.co/v2/search?country=IM&query=012345C" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
[
  {
    "id": "012345C",
    "legalName": "EXAMPLE HOLDINGS LIMITED",
    "countryCode": "IM",
    "matchReason": { "matchType": "id", "identifier": { "registrationNumber": "012345C" } }
  }
]
```

### Company Profile

Query: `POST /v2/company` with `{ "id": "<id>", "countryCode": "IM", "dataPoints": ["company"] }`

<AccordionGroup>
  <Accordion title="Live 1931 Act Company (C)">
    ```json theme={null}
    {
      "company": {
        "id": "012345C",
        "countryCode": "IM",
        "identifiers": { "registrationNumber": "012345C" },
        "legalName": "EXAMPLE HOLDINGS LIMITED",
        "incorporationDate": "2000-03-15",
        "status": { "localName": "Live", "active": true },
        "legalForm": { "localName": "Private Ltd by Shares" },
        "legalAddress": { "addressLine1": "1st Floor, Example House, Example Street, Douglas, Isle of Man, IM1 1AA", "countryCode": "IM" }
      }
    }
    ```
  </Accordion>

  <Accordion title="Dissolved 2006 Act Company (V)">
    ```json theme={null}
    {
      "company": {
        "id": "001234V",
        "countryCode": "IM",
        "identifiers": { "registrationNumber": "001234V" },
        "legalName": "EXAMPLE SERVICES LTD",
        "incorporationDate": "2012-06-04",
        "status": { "localName": "Dissolved", "active": false },
        "legalForm": { "localName": "Limited by shares" },
        "legalAddress": { "addressLine1": "2 Example Road, Ramsey, Isle of Man, IM8 1AA", "countryCode": "IM" }
      }
    }
    ```
  </Accordion>

  <Accordion title="Foundation (M)">
    ```json theme={null}
    {
      "company": {
        "id": "000345M",
        "countryCode": "IM",
        "identifiers": { "registrationNumber": "000345M" },
        "legalName": "Example Family Foundation",
        "status": { "localName": "Live", "active": true },
        "legalForm": { "localName": "Foundation" }
      }
    }
    ```

    **Note:** Foundations have no company type, so the legal form is the registry type. The register publishes no registered office address or incorporation date for them.
  </Accordion>

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

    | API Category              | Document                                                            | Notes                                |
    | ------------------------- | ------------------------------------------------------------------- | ------------------------------------ |
    | `tradeRegisterExtract`    | Company Summary                                                     | Available for every entity           |
    | `otherDocuments[]`        | Registry filings (for example Annual Return, Register Of Directors) | Depends on what the entity has filed |
    | `articlesOfAssociation[]` | Memorandum or articles of association filings                       | Only when the entity has filed one   |

    ```json theme={null}
    {
      "documents": {
        "tradeRegisterExtract": {
          "id": "3f2b8c1e-5d4a-5b6f-9e7d-1a2b3c4d5e6f",
          "name": "Company Summary",
          "format": "pdf",
          "description": "Trade register extract from the Isle of Man Companies Registry"
        },
        "otherDocuments": [
          {
            "id": "8a7b6c5d-4e3f-5a2b-8c1d-0e9f8a7b6c5d",
            "name": "Annual Return",
            "format": "pdf"
          },
          {
            "id": "c1d2e3f4-a5b6-5c7d-8e9f-0a1b2c3d4e5f",
            "name": "Register Of Directors",
            "format": "pdf"
          }
        ]
      }
    }
    ```
  </Accordion>
</AccordionGroup>