> ## Documentation Index
> Fetch the complete documentation index at: https://developer.kyckr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ireland (IE)

> Country guide for Irish company data including registry information, identifiers, legal forms, and data availability.

## Overview

<CardGroup cols={2}>
  <Card title="Registry" icon="building-columns">
    **CRO** (Companies Registration Office)

    Official company registry of Ireland
  </Card>
</CardGroup>

The Companies Registration Office (CRO) is the official registry for all companies and business names in Ireland. Basic company information is accessed directly from the CRO API, while enhanced data (directors, shareholders, share capital) is extracted from filed B1C Annual Return documents through automated document processing.

## Company Identifiers

| Identifier          | Format                   | Example  | Notes                      |
| ------------------- | ------------------------ | -------- | -------------------------- |
| Registration Number | Numeric, variable length | `175525` | No fixed length or padding |
| VAT Number          | N/A                      | N/A      | Not available from CRO     |

<Note>
  Irish company registration numbers have no fixed length or leading zeros. They are simply numeric identifiers assigned sequentially by the CRO.
</Note>

## Search Capabilities

| Search Method                 | Supported             |
| ----------------------------- | --------------------- |
| Search by registration number | Yes                   |
| Search by company name        | Yes (contains search) |

## Data Availability

### Companies

| Data Point           | LTD     | DAC     | ULC     | PLC     | CLG     | External |
| -------------------- | ------- | ------- | ------- | ------- | ------- | -------- |
| Registration details | Yes     | Yes     | Yes     | Yes     | Yes     | Yes      |
| Address              | Yes     | Yes     | Yes     | Yes     | Yes     | Yes      |
| Directors            | Yes\*   | Yes\*   | Yes\*   | Yes\*   | Yes\*   | Yes\*    |
| Company Secretary    | Yes\*   | Yes\*   | Yes\*   | Yes\*   | Yes\*   | Yes\*    |
| Shareholders         | Yes\*   | Yes\*   | Yes\*   | Yes\*   | Yes\*   | Limited  |
| Share Capital        | Yes\*   | Yes\*   | Yes\*   | Yes\*   | No      | No       |
| Group Structure      | Yes\*   | Yes\*   | Yes\*   | Yes\*   | Yes\*   | No       |
| Activity Codes       | Yes\*\* | Yes\*\* | Yes\*\* | Yes\*\* | Yes\*\* | Yes\*\*  |

\*Extracted from B1C Annual Return filings \*\*Via separate API (not in enhanced profile response)

<Info>
  **LTD** = Private Company Limited by Shares, **DAC** = Designated Activity Company, **ULC** = Private Unlimited Company, **PLC** = Public Limited Company, **CLG** = Company Limited by Guarantee
</Info>

### Business Names

| Data Point           | Individual | Body Corporate |
| -------------------- | ---------- | -------------- |
| Registration details | Yes        | Yes            |
| Address              | Yes        | Yes            |
| Owners               | Yes\*      | Yes\*          |
| Shareholders         | No         | No             |
| Share Capital        | No         | No             |

\*Extracted from filed documents

## Legal Forms

<AccordionGroup>
  <Accordion title="Private Companies">
    | Code | Abbreviation | Full Name                         | Notes                                 |
    | ---- | ------------ | --------------------------------- | ------------------------------------- |
    | 1153 | LTD          | Private Company Limited by Shares | Most common company type              |
    | 1150 | DAC          | Designated Activity Company       | Limited by shares, restricted objects |
    | 1157 | ULC          | Private Unlimited Company         | Unlimited liability                   |
    | 1155 | CLG          | Company Limited by Guarantee      | Non-profits, charities                |
  </Accordion>

  <Accordion title="Public Companies">
    | Code | Abbreviation | Full Name              | Notes                     |
    | ---- | ------------ | ---------------------- | ------------------------- |
    | 1154 | PLC          | Public Limited Company | Publicly traded companies |
  </Accordion>

  <Accordion title="Business Names">
    | Code | Type           | Description                    | Notes                                      |
    | ---- | -------------- | ------------------------------ | ------------------------------------------ |
    | 1130 | Individual     | Business name - Individual     | Sole trader trading under a different name |
    | 1132 | Body Corporate | Business name - Body Corporate | Company trading under a different name     |
  </Accordion>

  <Accordion title="European & Foreign Entities">
    | Code | Abbreviation | Full Name               | Notes                             |
    | ---- | ------------ | ----------------------- | --------------------------------- |
    | 1177 | SE           | Societas Europaea       | European company form             |
    | 1178 | External     | Foreign Registered Body | Foreign company with Irish branch |
  </Accordion>

  <Accordion title="Other Entity Types">
    | Code | Abbreviation | Full Name                                 | Notes               |
    | ---- | ------------ | ----------------------------------------- | ------------------- |
    | 1175 | ICAV         | Irish Collective Asset-management Vehicle | Investment funds    |
    | 1176 | -            | Investment Company                        | Investment entities |
  </Accordion>
</AccordionGroup>

## Status Codes

| Status             | Description                              | Normalized Status |
| ------------------ | ---------------------------------------- | ----------------- |
| Normal             | Active company                           | Active            |
| In Liquidation     | Liquidation proceedings in progress      | Distressed        |
| In Receivership    | Receivership proceedings in progress     | Distressed        |
| Strike-Off Listed  | Listed for removal from register         | Distressed        |
| Strike-Off Pending | Strike-off pending final dissolution     | Distressed        |
| Dissolved          | Company has been dissolved               | Inactive          |
| Examinership       | Court protection (similar to Chapter 11) | Distressed        |

## Activity Codes

Ireland uses **NACE Rev. 2** for classifying business activities.

| Field       | Description             | Example                         |
| ----------- | ----------------------- | ------------------------------- |
| `nace_code` | NACE Rev. 2 code format | `62.01`                         |
| `name`      | Activity description    | Computer programming activities |
| `version`   | NACE version            | `2`                             |

<Warning>
  Activity codes are sourced via a separate CRO Open Data API and are **not included** in the main enhanced profile response. The `activities` array will be populated by a separate service.
</Warning>

## Address Format

Irish addresses use a line-based structure from the CRO:

**Example format:**

```text theme={null}
SUITE 6, RINEANNA HOUSE, SHANNON FREE ZONE, CO. CLARE
```

### Address Components

| Component       | Maps To             | Description                    |
| --------------- | ------------------- | ------------------------------ |
| CompanyAddress1 | rawAddressLines\[0] | Primary line (building/street) |
| CompanyAddress2 | rawAddressLines\[1] | Secondary line (area/locality) |
| CompanyAddress3 | rawAddressLines\[2] | Region/county                  |
| CompanyAddress4 | rawAddressLines\[3] | Additional (often empty)       |
| Eircode         | postcode            | Irish postal code              |
| Country         | country             | Always "Ireland"               |

<Note>
  Eircode (Irish postal code) is not always present, particularly for older registrations or rural addresses.
</Note>

## Implementation Notes

<Warning>
  **Data Currency**: Director, secretary, and shareholder data is extracted from B1C Annual Return filings through document processing. This data reflects the **last filed annual return**, not real-time changes. Recent appointments, resignations, or share transfers may not be reflected until the next annual return is filed and processed.
</Warning>

<Note>
  **Joint Shareholdings**: When shares are jointly owned, shareholder names may appear combined in the source data (e.g., "JOHN DOE & JANE DOE"). These are split into separate entries in the API response.
</Note>

<Info>
  **Foreign Registered Bodies**: Companies with type code 1178 are foreign entities with an Irish branch or presence. The `registrationType` field will be "Foreign Registered Body" and `registrationTypeDetails` will contain the country of origin.
</Info>

### Representatives

| Role                      | Description             | Notes                                |
| ------------------------- | ----------------------- | ------------------------------------ |
| Director                  | Company director        | Primary governance role              |
| Company Secretary         | Statutory secretary     | Required for all Irish companies     |
| Registered Business Owner | Business name owner     | For business name registrations only |
| Ultimate Parent           | Ultimate parent company | From group structure data            |
| Immediate Parent          | Direct parent company   | From group structure data            |

### Capital Types

Share capital data is grouped by share class (e.g., "ORDINARY", "A ORDINARY", "PREFERENCE") with each class including:

* Total nominal value
* Currency (typically EUR)
* Shareholdings with percentage ownership

<Note>
  **CLG companies** (Companies Limited by Guarantee) and **External companies** (Foreign Registered Bodies) do not have share capital data, as CLGs have members rather than shareholders, and external companies' capital is registered in their home jurisdiction.
</Note>