> ## 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.
# Ireland
> Country-specific identifiers, data sources, and implementation details
## Start here
This guide contains public integration notes for Ireland. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
## Table of Contents
* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Fast search data](#fast-search-data)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Data Availability](#data-availability)
* [Example API Responses](#example-api-responses)
## Data Sources
All company data is sourced from the **Companies Registration Office (CRO)**, Ireland's central registry for companies, business names, and limited partnerships. The CRO was formally re-established under the Companies Act 2014, which consolidated Ireland's 17 prior Companies Acts (1963-2013) into a single statute that took effect on 1 June 2015.
Two distinct CRO interfaces are used:
* **CRO Public API** (`services.cro.ie`) -- The official web services API providing basic company profile data (name, status, legal form, registered address, registration date) and company search. Used as the **primary source** for structured company data. Authenticated via API key.
* **CRO Core Portal** (`core.cro.ie`) -- The CRO's online filing and enquiry platform. Used for **document listing and retrieval** (historical filings, certificates, reports, and generated extracts). Some document operations can be slower due to register-side access controls.
The CRO Public API provides only basic company profile data (name, status, legal form, address). It does **not** provide structured data for legal representatives, shareholders, or activity codes. Legal representatives and shareholders are instead extracted from CRO documents using AI parsing (see sections below).
### Data Source Priority & Routing
Ireland uses a single registry (CRO) with two access interfaces. Unlike France or Germany, there is no multi-source priority chain -- **all data comes from the CRO**:
1. **Company Profile** -- Live query to the CRO Public API (`services.cro.ie`)
2. **Legal Representatives & Other Key Persons** -- AI-extracted from the Company Printout document (retrieved from CRO Core)
3. **Shareholders** -- AI-extracted from the most recent B1C Annual Return document (retrieved from CRO Core)
4. **Documents** -- Listed and retrieved from CRO Core (`core.cro.ie`)
## Company Identifiers
### Query Identifiers
| Identifier | Format | Example | Notes |
| ------------------ | ----------------------------------------------- | ------- | ------------------------------------------------- |
| **Company Number** | Numeric (variable length, typically 5-6 digits) | `12965` | Primary CRO registration number. No zero-padding. |
Irish company numbers are purely numeric with no fixed length. Both `12965` and `308943` are valid formats. There is no check digit or prefix -- just the raw number assigned by the CRO at incorporation.
### Identifiers in API Response
| Identifier Type | Format | Example | Notes |
| --------------- | -------------- | --------- | ----------------------- |
| `companyNumber` | Numeric string | `"12965"` | CRO registration number |
**No VAT or tax identifiers.** The CRO API does not provide Irish VAT numbers (IE + 7-9 characters) or Revenue registration numbers. Only the CRO company number is returned.
## Search Capabilities
| Search Type | Pattern | Example | Match Type | Expected Results |
| ----------------- | -------------- | ---------------------- | ---------- | -------------------------------------------------------------------- |
| By Company Number | Numeric string | `12965` | Exact | Exact match returned first (matchType: id); other results may follow |
| By Company Name | Text string | `"CRH Public Limited"` | Contains | Multiple results |
**Search uses both the CRO Public API and CRO Core.** Name searches query the CRO Public API for matching companies. For each result, the system also resolves the CRO Core `entityId` (an internal identifier distinct from the registration number) which is needed for document operations.
Use company number searches for exact matching. Name searches use a "contains" match type and may return many results for common terms.
## Fast search data
Ireland company data is **periodically synchronized** from the CRO Open Data CSV into a fast search index.
### Search
Search queries hit the **fast search index first** for instant results, with automatic fallback to the live CRO API if the fast search index misses.
### Companies in fast search data
The fast search index contains **only active Irish entities** from the CRO dataset. Companies are filtered by CRO status code:
| Included Status | Code | Description |
| --------------- | ------ | ------------------------------ |
| Normal | `1151` | Active company |
| ReInstated HCO | `1160` | Reinstated by High Court order |
| ReInstated | `1161` | Reinstated |
All other status codes (Liquidation, Strike Off Listed, Struck Off, Dissolved, Ceased, etc.) are **excluded** from the fast search dataset.
### Onboarding Mode
In onboarding mode, requests for the `company` datapoint use the fast search dataset rather than a live CRO lookup. This provides faster responses with lighter enrichment. Data freshness depends on the source refresh schedule.
## Quirks & Gotchas
| Quirk | Details |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **No activity codes** | The Irish CRO does not provide SIC, NACE, or any industry classification codes. Unlike the UK (which provides SIC codes via Companies House), activity classification is entirely absent from CRO data. |
| **Legal reps from AI parsing** | Directors and secretaries are extracted from the Company Printout PDF using AI, not from a structured API endpoint. The CRO Public API does not expose officer data. |
| **Shareholders from B1C only** | Shareholders are AI-extracted from the most recent B1C (Annual Return with Accounts) document. Companies without a recent B1C return empty shareholders. |
| **B1C age limit** | B1C documents must cover at most the current year minus 2. In 2026, only B1Cs covering 2024 or later are accepted. Older filings are rejected to avoid stale data. |
| **Shareholders require active status** | Shareholder extraction only runs for companies with Active, Under Insolvency Proceeding, or Unknown status. Closed companies return no shareholders. |
| **entityId differs from company number** | The CRO Core portal uses an internal `entityId` that is different from the public registration number (e.g., company `104547` maps to `entityId` `139795`). This mapping is resolved automatically via search. |
| **Company number format varies** | Irish company numbers have no fixed length or zero-padding. Values like `12965`, `104547`, and `308943` are all valid. |
| **PDF multi-column parsing** | CRO Company Printout PDFs use multi-column layouts where sections may be interleaved. Page footers containing dates and "Company:" text must be distinguished from actual addresses. |
| **Register-side waiting room** | CRO Core can place document operations in a waiting room. Document operations handle this automatically. |
| **Document retrieval is asynchronous** | Document retrieve and download involves a multi-step process (retrieval, download, save) that typically takes 1-2 minutes per document. |
| **Most documents are fee-based** | Most CRO documents have a register fee. Some older filings for certain companies may be free. Check `availableDocuments` and live pricing before retrieval. |
| **CRO status text has trailing spaces** | The `company_status_desc` from the CRO API may include trailing whitespace (e.g., `"Normal "` instead of `"Normal"`). The `localName` preserves this verbatim. |
## Statutory Filings
Every Irish company has a **Next Annual Return Date (NARD)**, the date its annual return (Form B1) falls due. The CRO publishes it alongside the date of the last return filed, and both are returned on the cross-country `statutoryFilings` field.
The Irish annual return is the same obligation as the UK confirmation statement: a periodic confirmation that the company's particulars are current. It is **not** a financial filing, so it maps to `annualFiling`.
```json theme={null}
{
"statutoryFilings": {
"annualFiling": {
"cadence": "annual",
"lastFiled": { "periodEnd": "2025-05-23" },
"next": { "periodEnd": "2026-05-23" },
"source": "cro"
}
}
}
```
**The NARD is not the filing deadline.** The CRO defines the Annual Return Date as the latest date to which a return must be *made up*, and the return is then due within 56 days of it. Both dates are therefore reported as `periodEnd`, and no `dueDate` is published: treating the NARD as a deadline would mark every Irish company overdue about eight weeks early.
The deadline is not derived either, because it is not a plain 56 days. It extends to the next working day when it falls on a weekend or public holiday, and where financial statements must be annexed it is the earlier of ARD + 56 days and financial-year-end + 9 months + 56 days.
The `accounts` obligation is **not** returned for Ireland: the CRO company endpoint carries no accounts date. **Business names** (the `-B` register, sole traders) file no annual return at all, so `statutoryFilings` is absent for them.
See [Compliance Signals & Statutory Filings](/essentials/compliance-signals) for the full field reference.
## Mappings
### Company Status
Company status is determined **deterministically** from CRO numeric status codes -- no AI inference is involved.
| Code | CRO Status | Standardized Status | Closure Reason | Active? |
| ---- | -------------------------- | --------------------------- | -------------------------- | ------- |
| 1151 | Normal | Active | - | Yes |
| 1153 | Normal (Receivership) | Active | - | Yes |
| 1160 | ReInstated HCO | Active | - | Yes |
| 1161 | ReInstated | Active | - | Yes |
| 1162 | Interim | Active | - | Yes |
| 1154 | Examinership | Under Insolvency Proceeding | - | Yes |
| 1152 | Liquidation | Under Insolvency Proceeding | Liquidation | No |
| 1155 | Liquidation (Receivership) | Under Insolvency Proceeding | Liquidation | No |
| 1156 | Strike Off Listed | Under Insolvency Proceeding | Administrative Dissolution | No |
| 1157 | Struck Off | Closed | Administrative Dissolution | No |
| 1158 | Dissolved | Closed | Voluntary Dissolution | No |
| 1159 | Dissolved-20 years | Closed | Voluntary Dissolution | No |
| 1163 | Ceased | Closed | Other | No |
| 1173 | Dissolved PostMerger | Closed | Merger | No |
**Examinership** is an Irish insolvency process (similar to US Chapter 11) where the company remains active while under court protection. The company is mapped as `active: true` but with status `UNDER_INSOLVENCY_PROCEEDING` because it can still trade.
**Normal (Receivership)** means the company is in receivership but not in liquidation -- it remains active. A receiver manages specific assets while the company continues to operate.
### Legal Forms
Ireland's company types are defined by the Companies Act 2014 and earlier legislation. The CRO assigns a numeric `company_type_code` to each entity. The mapping to standardized forms is **deterministic** (hardcoded lookup table, not AI-inferred). ISO 20275 (ELF) codes will be populated in a future update.
Legal forms are classified from official registry data. For known codes, standardized classification is applied directly; for unrecognized codes, AI-based classification is used as fallback.
#### Limited Companies
| Local Name | English Translation | Standardized | ISO 20275 |
| ----------------------------------------------- | ------------------------------------------------------- | ------------------------- | --------- |
| Private limited by shares | Private Company Limited by Shares | Limited Liability Company | MNQ7 |
| LTD - Private Company Limited by Shares | Private Company Limited by Shares | Limited Liability Company | MNQ7 |
| Public limited company | Public Limited Company | Corporation | VYAX |
| PLC - Public Limited Company | Public Limited Company | Corporation | VYAX |
| Public limited company (closed ended) | Closed-Ended Public Limited Company | Corporation | VYAX |
| Single member private company limited by shares | Single Member Private Company Limited by Shares | Limited Liability Company | MNQ7 |
| Private, limited by shares, licence to omit ltd | Private Company Limited by Shares (Licence to Omit Ltd) | Limited Liability Company | MNQ7 |
#### Designated Activity Companies
| Local Name | English Translation | Standardized | ISO 20275 |
| --------------------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------- | --------- |
| DAC - Designated Activity Company (limited by shares) | Designated Activity Company (Limited by Shares) | Limited Liability Company | 5AX8 |
| DAC - Designated Activity Company (limited by shares) (Licenced Company) | Designated Activity Company (Limited by Shares, Licenced) | Limited Liability Company | 5AX8 |
| DAC - Designated Activity Company (limited by guarantee) | Designated Activity Company (Limited by Guarantee) | Limited Liability Company | 5AX8 |
| DAC - Designated Activity Company (limited by guarantee) (licenced company) | Designated Activity Company (Limited by Guarantee, Licenced) | Limited Liability Company | 5AX8 |
#### Unlimited Companies
| Local Name | English Translation | Standardized | ISO 20275 |
| ------------------------------------------------------------------------ | --------------------------------------------------------- | ------------------------- | --------- |
| Private unlimited with share capital | Private Unlimited Company with Share Capital | Limited Liability Company | KMFX |
| ULC - Private Unlimited Company | Private Unlimited Company | Limited Liability Company | KMFX |
| ULC - Private Unlimited Company (licenced company) | Private Unlimited Company (Licenced) | Limited Liability Company | KMFX |
| Public unlimited company with a share capital | Public Unlimited Company with Share Capital | Corporation | KMFX |
| PUC - Public Unlimited Company | Public Unlimited Company | Corporation | KMFX |
| Public unlimited company without share capital | Public Unlimited Company without Share Capital | Corporation | KMFX |
| PULC - Public Unlimited Company without share capital | Public Unlimited Company without Share Capital | Corporation | KMFX |
| PUC - Public Unlimited Company (licenced company) | Public Unlimited Company (Licenced) | Corporation | KMFX |
| PULC - Public Unlimited Company without share capital (licenced company) | Public Unlimited Company without Share Capital (Licenced) | Corporation | KMFX |
#### Guarantee Companies
| Local Name | English Translation | Standardized | ISO 20275 |
| ----------------------------------------------------- | ------------------------------------------------------------- | ------------------------- | --------- |
| Guarantee company without a share capital (public) | Public Guarantee Company without Share Capital | Limited Liability Company | C58S |
| Private guarantee with share capital | Private Company Limited by Guarantee with Share Capital | Limited Liability Company | C58S |
| CLG - Company Limited by Guarantee | Company Limited by Guarantee | Limited Liability Company | C58S |
| Guarantee licence company w/o sh/capital (public) | Public Guarantee Company (Licenced) | Limited Liability Company | C58S |
| Single member company ltd by g/tee with sh/cap | Single Member Company Limited by Guarantee with Share Capital | Limited Liability Company | LMIM |
| Private guarantee with shares, licence to omit ltd | Private Company Limited by Guarantee (Licence to Omit Ltd) | Limited Liability Company | C58S |
| CLG - Company Limited by Guarantee (licenced company) | Company Limited by Guarantee (Licenced) | Limited Liability Company | C58S |
#### Partnerships
| Local Name | English Translation | Standardized | ISO 20275 |
| ------------------- | ------------------- | ------------ | --------- |
| Limited Partnership | Limited Partnership | Partnership | HNJK |
#### Investment Companies
| Local Name | English Translation | Standardized | ISO 20275 |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------- | ------------------------- | --------- |
| Public limited company with variable capital | Investment Company with Variable Capital (Public) | Corporation | VYAX |
| Private company with variable capital | Investment Company with Variable Capital (Private) | Limited Liability Company | MNQ7 |
| Part XII Pub/Priv Investment Company | Investment Company (Part XII) | Corporation | MNQ7 |
| IC - Investment company - Part 24 Companies Act 2014 | Investment Company (Part 24, Companies Act 2014) | Corporation | 2GV9 |
| U.C.I.T | Undertaking for Collective Investment in Transferable Securities | Trust | - |
| UCITS - Undertaking for Collective Investment in Transferable Securities | Undertaking for Collective Investment in Transferable Securities | Trust | 2GV9 |
#### European Companies (Societas Europaea)
| Local Name | English Translation | Standardized | ISO 20275 |
| ------------------------------------------- | ------------------------------------------- | ------------ | --------- |
| Societas Europaea - New Incorporation | Societas Europaea (New Incorporation) | Corporation | JXDX |
| Societas Europaea - Transfer into State | Societas Europaea (Transfer into State) | Corporation | JXDX |
| Societas Europaea - Formation of Subsidiary | Societas Europaea (Formation of Subsidiary) | Corporation | JXDX |
| Societas Europaea - PLC conversion | Societas Europaea (PLC Conversion) | Corporation | JXDX |
| PLC - Societas Europaea conversion | Societas Europaea (from PLC Conversion) | Corporation | JXDX |
#### Foreign / Branch / Other
| Local Name | English Translation | Standardized | ISO 20275 |
| -------------------------------------------------- | ---------------------------- | ------------------------------ | --------- |
| Foreign Body Corporate making a local offer (B18a) | Foreign Branch (Local Offer) | Branch / Representative Office | - |
| Inward Migrating Company | Inward Migrating Company | Branch / Representative Office | - |
| Unknown | Unknown | Other | - |
**Standardization rationale:** Unlimited companies (ULC, PUC, PULC) are mapped to `Limited Liability Company` or `Corporation` based on their private/public nature, despite having unlimited member liability. This prioritizes corporate structure over liability model for consistent classification. Guarantee companies (CLG, DAC guarantee) are similarly mapped to `Limited Liability Company` as they are corporate bodies with separate legal personality.
### Legal Representatives
Legal representatives are **AI-extracted** from the CRO Company Printout document (trade register extract). The CRO Public API does not provide structured officer data.
| Role | Classification | Authority |
| --------------------------- | -------------------- | ------------------------------------------------------- |
| **Director** | Legal Representative | Statutory authority to bind the company |
| **Company Secretary** | Other Key Person | Statutory officer but no legal representation authority |
| **Electronic Filing Agent** | Other Key Person | Agent for CRO filings, no legal authority |
The classification of roles is defined by explicit parsing instructions, not by AI inference. Directors are always legal representatives; secretaries and filing agents are always other key persons.
Both individuals and companies can hold roles. Electronic Filing Agents are typically companies (e.g., accountancy firms), while directors and secretaries are typically individuals.
### Other Key Persons
| Role | English Translation | Notes |
| ----------------------- | ------------------- | ----------------------------------------------- |
| Company Secretary | Secretary | Statutory officer required by Irish law |
| Electronic Filing Agent | Filing Agent | Authorized agent for electronic CRO submissions |
### Shareholders
Shareholders are **AI-extracted** from the most recent **Form B1C** (Annual Return with Accounts) filed with the CRO. This is conceptually similar to the German approach of extracting shareholders from filed documents rather than structured registry data.
**Extraction process:**
1. Fetch available documents and find the most recent B1C form
2. Verify the B1C covers a recent period (within 2 years of the current year)
3. Retrieval and download the B1C document from CRO Core
4. OCR the PDF using Mistral OCR
5. Parse shareholders using AI (racing multiple models for speed)
**Data extracted per shareholder:**
| Field | Description | Example |
| ------------------------------------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------- |
| `type` | Individual or company | `"company"` |
| `sharePercentage` | Ownership percentage, computed from the share counts (share held ÷ total issued shares) | `99` |
| `numberOfShares` | Number of shares held | `2` |
| `nominalCapitalHeld` | Capital value with currency | `{ "amount": 2.54, "currency": "EUR" }` |
| `company.legalName` or `individual.name` | Shareholder name | `"Analysys Mason Limited"` |
| `company.legalAddress` or `individual.residenceAddress` | Parsed from B1C | Structured address object |
| `company.countryCode` or address `countryCode` | Derived from address | `"GB"` |
Shareholder names, share counts, and addresses are read from the B1C members and share tables; `sharePercentage` and `nominalCapitalHeld` are then computed from the printed share counts and issued share capital (not free-form estimates), so the same filing always yields the same figures.
**Example response** — the `shareholders` array for LinkedIn Technology Unlimited Company (CRO 477442), whose B1C lists two members:
```json theme={null}
[
{
"type": "company",
"company": {
"legalName": "LinkedIn International",
"countryCode": "IM",
"legalAddress": {
"addressLine1": "34 North Quay",
"city": "Douglas",
"postalCode": "IM2 4EY",
"countryCode": "IM"
}
},
"sharePercentage": 1,
"numberOfShares": 1,
"nominalCapitalHeld": { "amount": 1, "currency": "EUR" },
"source": "Extracted from B1C Annual Return (Form B1C - Annual Return General)"
},
{
"type": "company",
"company": {
"legalName": "Microsoft Ireland Research Unlimited Company",
"countryCode": "IE",
"legalAddress": {
"addressLine1": "70 Sir John Rogerson's Quay",
"city": "Dublin",
"countryCode": "IE"
}
},
"sharePercentage": 99,
"numberOfShares": 99,
"nominalCapitalHeld": { "amount": 99, "currency": "EUR" },
"source": "Extracted from B1C Annual Return (Form B1C - Annual Return General)"
}
]
```
**Limitations:**
| Limitation | Details |
| ---------------------- | ------------------------------------------------------------------------------------------------------ |
| Single document source | Only the most recent B1C is used; historical ownership changes are not tracked |
| B1C age limit | Must cover at most current year minus 2 (e.g., 2024+ in 2026). Older filings return empty shareholders |
| Active companies only | Only companies with Active, Under Insolvency Proceeding, or Unknown status |
| AI extraction quality | Best-effort reconstruction from document text; complex multi-column layouts may affect accuracy |
| Paid document | The B1C is automatically retrieved if not already available |
### Activity Code Mapping
Ireland does **not** provide activity codes (SIC, NACE, or any industry classification) through the CRO API. Activity classification is not part of the CRO company profile data.
Unlike the UK (which provides SIC codes via Companies House) or France (which provides NAF/APE codes), the Irish CRO does not include industry classification codes in its data. As a result, NACE and ISIC codes are not available for Irish companies.
## Data Availability
### Data Availability Matrix
| Data Type | Availability | Processing | Notes |
| --------------------- | ------------ | ---------- | ------------------------------------------------------------------------ |
| Company Profile | Yes | Sync | Name, status, legal form, address, registration date from CRO Public API |
| Legal Representatives | Yes | Async | AI-extracted from Company Printout (trade register extract) |
| Other Key Persons | Yes | Async | Secretaries and filing agents from Company Printout |
| Shareholders | Yes | Async | AI-extracted from B1C Annual Return (paid document) |
| Establishments | No | - | CRO does not provide branch/establishment data |
| Activity Codes | No | - | CRO does not provide SIC/NACE codes |
| Documents | Yes | Async | Extensive historical filings from CRO Core |
**Legend:** Sync = synchronous (seconds) | Async = asynchronous processing (1-2 minutes)
### Documents by Company Type
Documents are sourced from **CRO Core** (`core.cro.ie`) and organized into three categories: documents (filings), certificates, and reports.
| Document Type | API Category | Format | Catalog item | Description |
| -------------------------------------- | ------------------------- | ------ | ---------------------- | ------------------------------------------------------------- |
| **Company Printout** | `tradeRegisterExtract` | PDF | `IRL_COMPANY_PRINTOUT` | Current company details from registry (no financial accounts) |
| **Financial Statements** | `financialStatements[]` | PDF | `IRL_DOCUMENTS` | Annual accounts, auditor reports, account details |
| **Company Constitution** | `articlesOfAssociation[]` | PDF | `IRL_DOCUMENTS` | Constitutional documents defining governance rules |
| **B1C Annual Return** | `otherDocuments[]` | PDF | `IRL_DOCUMENTS` | Annual return with accounts (shareholder data source) |
| **B1 Annual Return** | `otherDocuments[]` | PDF | `IRL_DOCUMENTS` | Annual return without accounts |
| **B10 Director/Secretary Changes** | `otherDocuments[]` | PDF | `IRL_DOCUMENTS` | Director or secretary appointment/resignation filings |
| **Charge Documents (C1, C2, C6, C17)** | `otherDocuments[]` | PDF | `IRL_DOCUMENTS` | Mortgage/charge creation, satisfaction, and updates |
| **Share Capital (B5, B7)** | `otherDocuments[]` | PDF | `IRL_DOCUMENTS` | Share allotments and capital structure changes |
| **Resolutions (G1, G2)** | `otherDocuments[]` | PDF | `IRL_DOCUMENTS` | Special and ordinary shareholder resolutions |
| **A1 Incorporation** | `otherDocuments[]` | PDF | `IRL_DOCUMENTS` | Original application to register as a new company |
| **Letter of Status** | `otherDocuments[]` | PDF | `IRL_REPORTS` | Official letter confirming company current status |
| **Certificates** | `otherDocuments[]` | PDF | `IRL_CERTIFICATES` | Charge certificates, name change certificates, etc. |
**Document pricing varies** — see the pricing page for current rates per document type. Most documents (filings and certificates, and reports like Company Printout and Letter of Status) are paid; some older filings for certain companies may be free. For structured data pricing, Topograph bills Company Printout-backed people data separately from B1C-backed shareholder data. The system uses a global retrieval lock to prevent duplicate downloads.
**B1C priority sorting.** When listing available documents, B1C (Annual Return with Accounts) forms are prioritized at the top of the document list, followed by other documents sorted by date descending. This ensures the most useful documents for due diligence appear first.
### Example API Responses
All examples use **placeholder data**. Query: `POST /v2/company` with `{ "id": "", "countryCode": "IE", "dataPoints": ["company", "legalRepresentatives"] }`
```json theme={null}
{
"company": {
"id": "654321",
"countryCode": "IE",
"identifiers": {
"companyNumber": "654321"
},
"legalName": "EXAMPLE SOLUTIONS LIMITED",
"registrationDate": "2019-04-10",
"status": {
"localName": "Normal",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "LTD - Private Company Limited by Shares",
"englishTranslation": "LTD - Private Company Limited by Shares",
"standardized": "Limited Liability Company",
"iso20275Code": "MNQ7"
},
"legalAddress": {
"addressLine1": "15 Fitzwilliam Square",
"city": "Dublin",
"postalCode": "D02 XY12",
"countryCode": "IE"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": {
"localName": "Director",
"standardized": "Director"
},
"individual": {
"name": { "fullName": "John Murphy", "firstName": "John", "lastName": "Murphy" }
}
},
{
"type": "individual",
"role": {
"localName": "Director",
"standardized": "Director"
},
"individual": {
"name": { "fullName": "Mary O'Brien", "firstName": "Mary", "lastName": "O'Brien" }
}
}
],
"otherKeyPersons": [
{
"type": "individual",
"role": { "localName": "Secretary", "standardized": "Secretary" },
"individual": {
"name": { "fullName": "Patrick Kelly", "firstName": "Patrick", "lastName": "Kelly" }
}
},
{
"type": "company",
"role": { "localName": "Electronic Filing Agent", "standardized": "Other" },
"company": {
"legalName": "Dublin Accountancy Services Ltd"
}
}
]
}
```
```json theme={null}
{
"company": {
"id": "112233",
"countryCode": "IE",
"identifiers": {
"companyNumber": "112233"
},
"legalName": "EMERALD HOLDINGS PUBLIC LIMITED COMPANY",
"registrationDate": "1985-03-20",
"status": {
"localName": "Normal",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "PLC - Public Limited Company",
"englishTranslation": "PLC - Public Limited Company",
"standardized": "Corporation",
"iso20275Code": "VYAX"
},
"legalAddress": {
"addressLine1": "42 Fitzwilliam Square",
"city": "Dublin 2",
"postalCode": "D02 R279",
"countryCode": "IE"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": { "localName": "Director", "standardized": "Director" },
"individual": { "name": { "fullName": "Sean Fitzgerald", "firstName": "Sean", "lastName": "Fitzgerald" } }
},
{
"type": "individual",
"role": { "localName": "Director", "standardized": "Director" },
"individual": { "name": { "fullName": "Aoife Byrne", "firstName": "Aoife", "lastName": "Byrne" } }
}
],
"otherKeyPersons": [
{
"type": "company",
"role": { "localName": "Secretary", "standardized": "Secretary" },
"company": { "legalName": "Corporate Services Ireland Ltd" }
}
]
}
```
```json theme={null}
{
"company": {
"id": "445566",
"countryCode": "IE",
"identifiers": {
"companyNumber": "445566"
},
"legalName": "OLD TRADING COMPANY LIMITED",
"registrationDate": "2005-01-15",
"status": {
"localName": "Struck Off",
"active": false,
"statusDetails": {
"status": "CLOSED",
"closureReason": "ADMINISTRATIVE_DISSOLUTION",
"closureDate": "2020-09-15T00:00:00Z"
}
},
"legalForm": {
"localName": "LTD - Private Company Limited by Shares",
"standardized": "Limited Liability Company"
},
"legalAddress": {
"addressLine1": "10 Patrick Street",
"city": "Cork",
"countryCode": "IE"
}
},
"legalRepresentatives": []
}
```
**Note:** Closed companies may have no active legal representatives extracted. The `closureDate` is populated from the CRO status date when the company's status is CLOSED.
```json theme={null}
{
"company": {
"id": "778899",
"countryCode": "IE",
"identifiers": {
"companyNumber": "778899"
},
"legalName": "INSOLVENT MANUFACTURING LIMITED",
"registrationDate": "1995-08-10",
"status": {
"localName": "Liquidation(Receivership)",
"active": false,
"statusDetails": {
"status": "UNDER_INSOLVENCY_PROCEEDING",
"closureReason": "LIQUIDATION"
}
},
"legalForm": {
"localName": "CLG - Company Limited by Guarantee",
"englishTranslation": "CLG - Company Limited by Guarantee",
"standardized": "Limited Liability Company",
"iso20275Code": "C58S"
},
"legalAddress": {
"addressLine1": "13 City Quay",
"city": "Dublin 2",
"postalCode": "D02 ED70",
"countryCode": "IE"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": { "localName": "Director", "standardized": "Director" },
"individual": { "name": { "fullName": "Ciaran Walsh" } }
}
]
}
```
Query with `"dataPoints": ["shareholders"]`:
```json theme={null}
{
"shareholders": [
{
"type": "company",
"sharePercentage": 100,
"numberOfShares": 2,
"nominalCapitalHeld": { "amount": 2.54, "currency": "EUR" },
"source": "Extracted from B1C Annual Return (Form B1C - Annual Return General (SR7613068))",
"company": {
"legalName": "Parent Holdings Limited",
"countryCode": "GB",
"legalAddress": {
"addressLine1": "North West Wing, Bush House, Aldwych",
"city": "London",
"postalCode": "WC2B 4PJ",
"countryCode": "GB"
}
}
}
]
}
```
**Note:** Shareholders include a `source` field indicating which B1C document they were extracted from. Both individual and company shareholders are supported. The `countryCode` is derived from the shareholder's address, not the filing country.
Documents are returned when `"dataPoints": ["availableDocuments"]` is requested.
```json theme={null}
{
"documents": {
"tradeRegisterExtract": {
"id": "f61acfca-9b34-52a7-b4f2-41c652f91394",
"name": "Company Printout",
"description": "Current company details from registry - does not include financial accounts",
"format": "pdf",
"price": 5.50
},
"financialStatements": [
{
"id": "8d376fa9-4adb-57a5-94d7-b7a1131778ac",
"name": "FINANCIAL STATEMENT (SR371822)",
"description": "Company financial statements and accounts - Filed on 2025-04-14, effective 2020-03-31",
"format": "pdf",
"date": "2025-04-14",
"price": 0.00
}
],
"articlesOfAssociation": [
{
"id": "7b570df7-b0f5-5655-9593-65b2a2a4309b",
"name": "AMENDED CONSTITUTION (3528381)",
"description": "Company constitutional document defining governance rules - Filed on 2004-02-06",
"format": "pdf",
"date": "2004-02-05",
"price": 0.00
}
],
"otherDocuments": [
{
"id": "d3af92b7-1e22-5dad-84ec-1e9f3c5926ab",
"name": "Form B1C - Annual Return General (SR371822)",
"description": "Yearly company filing including financial accounts - Filed on 2025-04-14, effective 2020-03-31",
"format": "pdf",
"date": "2025-04-14",
"price": 0.00
},
{
"id": "c9ed0cc7-aa0a-5831-b50b-b5797e2af8d7",
"name": "Letter of status - Companies",
"description": "Official letter confirming company current status",
"format": "pdf",
"price": 0.00
}
]
}
}
```
**Note:** Document names include the CRO submission reference in parentheses (e.g., `SR371822`). Descriptions include filing and effective dates when available. Prices are in EUR.
```json theme={null}
{
"company": {
"id": "12965",
"countryCode": "IE",
"identifiers": { "companyNumber": "12965" },
"legalName": "CRH PUBLIC LIMITED COMPANY",
"registrationDate": "1949-06-19",
"status": { "localName": "Normal ", "active": true, "statusDetails": { "status": "ACTIVE" } },
"legalForm": { "localName": "PLC - Public Limited Company" },
"legalAddress": { "addressLine1": "42 FITZWILLIAM SQUARE", "postalCode": "D02R279", "countryCode": "IE" }
}
}
```
**Note:** Onboarding profiles are served from the fast search source. No AI enrichment -- no `standardized` or `iso20275Code` on legal form, no shareholders, no activity codes.