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

# Cayman Islands

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

## Start here

This guide contains public integration notes for Cayman Islands. 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="Cayman Islands coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/ky">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Warning>
  This jurisdiction may be in preview or limited availability. Check the live pricing page or contact support before relying on it in production.
</Warning>

<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

All Cayman Islands company data is sourced from the **General Registry of the Cayman Islands**, the official registrar of companies, partnerships, and trusts. The registry maintains records of over 120,000 active companies.

The system uses three paid report types from the CIREGISTRY online portal (`online.ciregistry.gov.ky`), all delivered as PDF documents and AI-parsed for structured data. Each report contains a distinct, non-overlapping subset of company data.

* **Detailed Search Report** (`cym-register-extract`). A summary of the company's constitutional documents: legal name, entity type, registration number and date, registered office, initial subscriber, authorised share capital, nature of business, financial year end, and status. Does **not** contain directors, officers, or members. This is the primary source for the `company` datapoint.

* **Basic Information / Company Details** (`cym-company-details`). A lighter report with the same core identity fields as the Detailed Search Report. Useful as a cheaper alternative when no constitutional context is needed.

* **List of Directors / Director Details** (`cym-director-details`). The only report that contains director and officer information. Lists **current directors only**, per the Companies Act. This is the source for the `legalRepresentatives` datapoint.

<Warning>
  **The Detailed Search Report does not contain directors or shareholders.** Despite the name, this report is a summary of a company's constitutional records. To retrieve directors, the List of Directors report must be retrieved separately. Shareholders are not available from the Registry at all (see Quirks below).
</Warning>

<Note>
  **All reports require retrieve.** The General Registry does not provide a free public API. Every data retrieval requires retrieving a document from the CIREGISTRY online portal. Documents retrieved within the last 24 hours can be re-downloaded free of charge.
</Note>

<AccordionGroup>
  <Accordion title="How are documents retrieved?">
    Documents are retrieved through an automated process:

    1. **Authentication**: The system maintains a pool of pre-authenticated sessions with the CIREGISTRY portal
    2. **Entity Search**: The entity is located by name on the portal
    3. **Document retrieval**: The selected document is retrieved using pre-loaded search credit
    4. **PDF Download**: The document is downloaded as a PDF immediately after retrieve
    5. **AI Parsing**: Text is extracted from the PDF and parsed by AI to produce structured data

    The entire process takes approximately 30-60 seconds per document.
  </Accordion>
</AccordionGroup>

## Company Identifiers

### Query Identifiers

| Company Type     | Source     | Format                       | Example                                        | Notes                                                              |
| ---------------- | ---------- | ---------------------------- | ---------------------------------------------- | ------------------------------------------------------------------ |
| **All entities** | CIREGISTRY | Entity name (base64-encoded) | `QlVUVEVSRklFTEQgQkFOSyAoQ0FZTUFOKSBMSU1JVEVE` | The registry has no numeric IDs; entity names serve as identifiers |

<Warning>
  **No numeric registration numbers.** Unlike most jurisdictions, the Cayman Islands General Registry does not assign numeric registration numbers to entities. The entity's legal name is the sole identifier. In the API, the `registrationNumber` field contains a base64-encoded version of the entity name.
</Warning>

<Tip>
  **Decoding the ID:** The `registrationNumber` returned in search results and company profiles is the entity name encoded in base64. Decode it to get the entity's legal name (e.g., `QlVUVEVSRklFTEQgQkFOSyAoQ0FZTUFOKSBMSU1JVEVE` → `BUTTERFIELD BANK (CAYMAN) LIMITED`).
</Tip>

### Identifiers in API Response

| Identifier Type      | Format                     | Example                 | Notes                        |
| -------------------- | -------------------------- | ----------------------- | ---------------------------- |
| `registrationNumber` | Base64-encoded entity name | `QlVUVEVSRklFTEQgQk...` | Decode to get the legal name |

<Note>
  Cayman Islands entities do not have VAT numbers, tax IDs, or other secondary identifiers in the public registry. The entity name is the sole identifier.
</Note>

## Search Capabilities

| Search Type     | Pattern                   | Example             | Match Type | Expected Results |
| --------------- | ------------------------- | ------------------- | ---------- | ---------------- |
| By Name         | Text string (2-100 chars) | `"Cayman National"` | Contains   | Multiple results |
| By Partial Name | Text string (min 2 chars) | `"Bank"`            | Contains   | Multiple results |

<Note>
  **Search is name-only.** Since the registry has no numeric IDs, all searches are by entity name. The search queries the CIREGISTRY portal in real time using a pre-authenticated session.
</Note>

<Tip>
  **Search performance:** Searches use a pool of pre-authenticated sessions to avoid the 30-60 second login time. With a pooled session, searches typically complete in 10-15 seconds.
</Tip>

## Quirks & Gotchas

| Quirk                                 | Details                                                                                                                                                                                                                                                                          |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **No numeric IDs**                    | Entity names are the only identifier. The `registrationNumber` field contains a base64-encoded entity name, not a numeric ID. Cayman companies do have an internal numeric registration number visible on reports, but it is not usable as a query key.                          |
| **Shareholders are not public**       | The Cayman Islands Registrar does not make the register of members available to the public. The register is held by the company's registered office, not the Registry. `shareholders` cannot be delivered for any Cayman entity via this integration, regardless of entity type. |
| **Only current directors**            | The Companies Act only requires the Registrar to make available the names of **current** directors. Historical / former directors are not available.                                                                                                                             |
| **Struck-off records are not public** | Records of companies removed from the register (struck, dissolved, de-registered) are not accessible. Requests for these entities will fail at source.                                                                                                                           |
| **All data is paid**                  | There is no free public API. Every report must be retrieved from the CIREGISTRY portal.                                                                                                                                                                                          |
| **Corporate directors**               | Cayman Islands companies frequently have corporate entities as directors, especially exempted companies. Directors may be of type `LEGAL_ENTITY` rather than `NATURAL_PERSON`.                                                                                                   |
| **24-hour re-download**               | Reports retrieved from CIREGISTRY can be re-downloaded free of charge within 24 hours of the original retrieve.                                                                                                                                                                  |
| **Registered Agent ≠ Director**       | The Registered Agent is a required appointment but is not a legal representative. Do not confuse with directors.                                                                                                                                                                 |
| **AI-parsed data**                    | Structured data is AI-extracted from PDF reports. Some fields may be approximate.                                                                                                                                                                                                |

## Mappings

### Company Status

Status is read from the **Status** field of the Detailed Search Report.

| Local Status   | Standardized Status         | Notes                                         |
| -------------- | --------------------------- | --------------------------------------------- |
| Active         | Active                      | Entity is currently operating                 |
| Dissolved      | Closed                      | Entity has been formally dissolved            |
| Struck Off     | Closed                      | Entity removed from register by the Registrar |
| In Liquidation | Under Insolvency Proceeding | Entity is being wound up                      |

### Legal Forms

Legal form is derived from the **Entity Type** field on the Detailed Search Report.

| Local Name                         | English Translation          | Notes                                                                                  |
| ---------------------------------- | ---------------------------- | -------------------------------------------------------------------------------------- |
| Exempted Company                   | Exempted Company             | Most common type for offshore entities; not required to hold annual meetings in Cayman |
| Exempted Limited Partnership       | Exempted Limited Partnership | Partnership with at least one general and one limited partner                          |
| Ordinary Resident Company          | Ordinary Resident Company    | Company that carries on business within the Cayman Islands                             |
| Foreign Company                    | Foreign Company              | Company incorporated outside Cayman but registered locally                             |
| Limited Liability Company (LLC)    | Limited Liability Company    | Hybrid entity combining corporate and partnership features                             |
| Segregated Portfolio Company (SPC) | Segregated Portfolio Company | Entity with legally segregated portfolios; common for funds                            |
| Foundation Company                 | Foundation Company           | Entity without shareholders; governed by a supervisor and secretary                    |

### Legal Representatives

Legal representatives are extracted from the **List of Directors** report (`cym-director-details`). This report lists current directors and officers only.

| Role               | Notes                                                  |
| ------------------ | ------------------------------------------------------ |
| Director           | Standard director role; may be individual or corporate |
| Alternate Director | Appointed to act in place of a named director          |
| Secretary          | Corporate secretary (if disclosed)                     |

<Note>
  **Corporate directors** are common in Cayman Islands companies. When a director is a legal entity rather than an individual, it is returned with `type: "LEGAL_ENTITY"` and the entity name in the `legalName` field.
</Note>

<Warning>
  **No historical directors.** The Companies Act only obliges the Registrar to publish the names of current directors. Former directors are not available from the registry.
</Warning>

### Shareholders

Shareholder data is **not available** for Cayman Islands entities. The Cayman Islands Registrar does not hold or publish the register of members. The register is kept privately at the company's registered office and is not accessible through the CIREGISTRY portal for any entity type.

If a customer needs shareholder information for a resident (local) Cayman company, a Certificate of Shareholders can be retrieved manually via the Cayman Business Portal (CBP), which is separate from the CIREGISTRY portal used by this integration. This is not currently offered as an automated datapoint.

## Data Availability

### Data Availability Matrix

| Data Point               | Source                 | Available    | Notes                                                 |
| ------------------------ | ---------------------- | ------------ | ----------------------------------------------------- |
| Legal name               | Detailed Search Report | Always       | Primary identifier for the entity                     |
| Status                   | Detailed Search Report | Always       | Active, Dissolved, Struck Off, In Liquidation         |
| Legal form               | Detailed Search Report | Always       | From the Entity Type field                            |
| Registration number      | Detailed Search Report | Always       | Internal numeric ID assigned by the Registry          |
| Registration date        | Detailed Search Report | Always       | Date of original incorporation                        |
| Registered office        | Detailed Search Report | Always       | Always in Cayman Islands; postal code format KY#-#### |
| Authorised share capital | Detailed Search Report | Always       | In Cayman dollars (CI\$)                              |
| Nature of business       | Detailed Search Report | Always       | Free-text description                                 |
| Directors                | List of Directors      | Current only | Includes corporate directors; no historical data      |
| Shareholders             | Not available          | Never        | Register of members is not public in Cayman           |

### Documents

| Document               | Catalog item           | Content                                                                                 |
| ---------------------- | ---------------------- | --------------------------------------------------------------------------------------- |
| Detailed Search Report | `cym-register-extract` | Summary of constitutional documents: identity, registered office, share capital, status |
| Basic Information      | `cym-company-details`  | Lighter identity report: name, type, status, incorporation date, registered office      |
| List of Directors      | `cym-director-details` | Current directors and officers only                                                     |

<Tip>
  The `company` datapoint is delivered by retrieving the Detailed Search Report. The `legalRepresentatives` datapoint is delivered by retrieving the separate List of Directors report. Requesting both datapoints in the same call will result in two separate retrieves from the CIREGISTRY portal.
</Tip>

## Example API Responses

<AccordionGroup>
  <Accordion title="Active Exempted Company">
    ```json theme={null}
    {
      "company": {
        "id": "T0NFQU5JQyBIT0xESU5HUyAoQ0FZTUFOKSBMSU1JVEVE",
        "countryCode": "KY",
        "legalName": "OCEANIC HOLDINGS (CAYMAN) LIMITED",
        "status": "active",
        "statusDetail": "Active",
        "legalForm": "Exempted Company",
        "incorporationDate": "2018-03-15",
        "registeredAddress": {
          "streetAddress": "PO Box 309, Ugland House, George Town",
          "city": "George Town",
          "postalCode": "KY1-1104",
          "country": "KY"
        },
        "identifiers": {
          "registrationNumber": "T0NFQU5JQyBIT0xESU5HUyAoQ0FZTUFOKSBMSU1JVEVE"
        }
      },
      "legalRepresentatives": [
        {
          "firstName": "John",
          "lastName": "Smith",
          "position": "Director",
          "type": "NATURAL_PERSON"
        },
        {
          "legalName": "Corporate Services Ltd",
          "position": "Director",
          "type": "LEGAL_ENTITY"
        }
      ],
      "shareholders": []
    }
    ```

    <Note>
      Shareholders array is empty because exempted companies are not required to publicly disclose shareholder information.
    </Note>
  </Accordion>

  <Accordion title="Active Ordinary Resident Company">
    ```json theme={null}
    {
      "company": {
        "id": "SVNMQU5EIFRSQURJTkcgQ08uIExJTUlURUQ=",
        "countryCode": "KY",
        "legalName": "ISLAND TRADING CO. LIMITED",
        "status": "active",
        "statusDetail": "Active",
        "legalForm": "Ordinary Resident Company",
        "incorporationDate": "2015-07-22",
        "registeredAddress": {
          "streetAddress": "45 Harbour Drive, George Town",
          "city": "George Town",
          "postalCode": "KY1-1205",
          "country": "KY"
        },
        "identifiers": {
          "registrationNumber": "SVNMQU5EIFRSQURJTkcgQ08uIExJTUlURUQ="
        }
      },
      "legalRepresentatives": [
        {
          "firstName": "Jane",
          "lastName": "Doe",
          "position": "Director",
          "type": "NATURAL_PERSON"
        }
      ],
      "shareholders": []
    }
    ```

    <Note>
      Shareholders are always an empty array for Cayman entities. The register of members is not public in Cayman.
    </Note>
  </Accordion>

  <Accordion title="Dissolved Company">
    ```json theme={null}
    {
      "company": {
        "id": "U1VOU0VUIElOVkVTVE1FTlRTIExJTUlURUQ=",
        "countryCode": "KY",
        "legalName": "SUNSET INVESTMENTS LIMITED",
        "status": "closed",
        "statusDetail": "Dissolved",
        "legalForm": "Exempted Company",
        "incorporationDate": "2010-01-10",
        "registeredAddress": {
          "streetAddress": "Cricket Square, Elgin Avenue, George Town",
          "city": "George Town",
          "postalCode": "KY1-1002",
          "country": "KY"
        },
        "identifiers": {
          "registrationNumber": "U1VOU0VUIElOVkVTVE1FTlRTIExJTUlURUQ="
        }
      },
      "legalRepresentatives": [],
      "shareholders": []
    }
    ```
  </Accordion>

  <Accordion title="Available Documents">
    All three reports are available for every active entity found via search:

    | Document               | Catalog item           | Format |
    | ---------------------- | ---------------------- | ------ |
    | Detailed Search Report | `cym-register-extract` | PDF    |
    | Basic Information      | `cym-company-details`  | PDF    |
    | List of Directors      | `cym-director-details` | PDF    |
  </Accordion>
</AccordionGroup>