Ireland - Topograph

This guide is outdated and will be removed on 1 November 2026. The up-to-date Ireland reference is on the Ireland country page.

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.

Ireland coverage, pricing, and sources

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.

Data Sources
Company Identifiers
Search Capabilities
Fast search data
Quirks & Gotchas
Mappings
Data Availability
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. Three CRO sources are used:

CRO Public API — 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.
CRO Open Data — The company dataset supplies declared NACE Rev. 2 classifications when available.
CRO Core Portal — The CRO’s online filing and enquiry platform. Used for document listing and retrieval (historical filings, certificates, reports, and generated extracts).

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 register (CRO) with several access interfaces. Unlike France or Germany, there is no multi-source priority chain — all data comes from the CRO:

Company Profile — Live query to the CRO Public API, supplemented with declared activity codes from CRO Open Data
Legal Representatives & Other Key Persons — AI-extracted from the Company Printout document (or the Business Name Profile for registered business names), retrieved from CRO Core
Shareholders — AI-extracted from the most recent annual return (B1C preferred, then B1, then B1C3), retrieved from CRO Core
Documents — Listed and retrieved from CRO Core

Company Identifiers

company.identifiers.euid is an optional European Unique Identifier. Supported domestic private and public companies limited by shares, including DACs limited by shares. Business names are excluded. Example: IECRO.368047. It is returned as an output identifier and cannot be used as a search input. See EUID coverage and interpretation.

Query Identifiers

Identifier	Format	Example	Notes
Company Number	1 to 6 digits	`368047`	Primary CRO registration number. No zero-padding.
Business Name Number	CRO number + `-B` suffix	`131910-B`	Registered business names (sole traders and trading names) on the CRO Business Names register
VAT Number	`IE` + 7 digits + 1 or 2 letters (the `IE` prefix is optional)	`IE6388047V`	Search only. Validated in VIES, then resolved to the company through the name VIES returns. Older numbers with a letter in second position (such as `IE1Z23456A`) are not recognised

Irish company numbers are numeric with no fixed length. Both 12965 and 308943 are valid formats. There is no check digit or prefix.The same CRO number can belong to both a company and a registered business name (for example, 131910 is a company and 131910-B is an unrelated business name). Use the -B suffix to address the business name; the bare number always addresses the company.

Identifiers in API Response

Identifier Type	Format	Example	Notes
`companyNumber`	Numeric string	`"368047"`	CRO registration number. For a business name this is the bare number: the `-B` suffix appears only in `company.id` and in the search result `id`
`euid`	`IECRO.` + CRO number	`"IECRO.368047"`	Supported domestic companies only; never on a business name

VAT is searchable but not returned. You can search with an Irish VAT number, but the CRO does not publish VAT numbers or Revenue registration numbers, so no VAT or tax identifier is returned under identifiers. The CRO company number, an eligible EUID, and an optional matched LEI may be returned.

Legal Entity Identifier (LEI)

GLEIF is the supplementary data source for this identifier. company.identifiers.lei is optional. It is returned when the CRO company number matches a registration or validation reference in GLEIF and identifies a single LEI. Registered business names with a -B identifier are excluded because their numbers overlap with unrelated companies. The LEI has 20 uppercase letters and digits, ending in two digits. Coverage varies by entity; a missing LEI does not establish that the company has none. Lapsed or retired LEIs can still be returned. Annulled LEIs are excluded, so the presence of this identifier does not establish current LEI registration status.

Search Capabilities

Search Type	Pattern	Example	Match Type	Expected Results
By Company Number	Numeric string	`12965`	Exact	Exact match returned first (matchType: id); a business name sharing the number is returned as a separate result with its `-B` id
By Business Name Number	Number + `-B`	`131910-B`	Exact	The registered business name only
By VAT Number	`IE` + 7 digits + 1 or 2 letters	`IE6388047V`	Name from VIES	The number is validated in VIES, then the CRO is searched by the name VIES returns
By Company Name	Text string	`"CRH Public Limited"`	Contains	Multiple results, across companies, business names, and external companies

Companies and business names are distinct results. Name and number searches cover the Companies, Business Names, and External Companies registers. A business name always carries the -B suffix in its id, so it never collides with a company that has the same CRO number.

Use company number searches for exact matching. Name searches use a “contains” match type and may return many results for common terms.

Active companies only

Search can return companies that are no longer active. Each result carries the register’s status, so activeOnly=true removes the inactive ones.

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.

Prefill Mode

In prefill 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. The dataset covers the Companies register only, so registered business names (-B ids) are read live from the CRO in prefill mode.

Quirks & Gotchas

Quirk	Details
Activity coverage varies	CRO Open Data provides a NACE Rev. 2 class for some companies. Companies without a valid declared class and registered business names have no activity codes.
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 the latest annual return	Shareholders are AI-extracted from the most recent annual return. The B1C (Annual Return with Accounts) is preferred, then a plain B1, then a B1C3, all within the same age limit. Shareholders are empty when none of these forms is recent enough.
Annual return age limit	The annual return must cover at most the current year minus 2. In 2026, only returns 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.
Business names have no shareholders	A registered business name (`-B` id) issues no shares. Requesting `shareholders` returns a `datapoint_not_applicable` error; the registered owner(s) are returned under `legalRepresentatives`.
Company number format varies	Irish company numbers are 1 to 6 digits, with 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.
Document retrieval is asynchronous	Document retrieve and download involves a multi-step process (retrieval, download, save) that typically takes 1-2 minutes per document.
Letter of Status is delivered later	The CRO produces the Letter of Status after the order, and it arrives about one business day later. Consume it through the webhook or by polling the request.
Documents are priced per type	Check `availableDocuments` and the pricing page for the price of each document type 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.

{
  "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 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 are returned where one exists for the form, as shown in the tables below.

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.

Business Names

Local Name	English Translation	Standardized	ISO 20275
Business name - Individual	Business Name (Sole Trader)	Sole Proprietorship	-
Business name - Partnership	Business Name (Partnership)	Partnership	-
Business name - Body Corporate	Business Name (Body Corporate)	Other	-

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
External company	External Company	Branch or Representative Office	-
Foreign Body Corporate making a local offer (B18a)	Foreign Branch (Local Offer)	Branch or Representative Office	-
Inward Migrating Company	Inward Migrating Company	Branch or 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	Other Key Person (`Board Member`) unless individual authority is recorded	The board acts as a body; the title alone does not establish personal signing powers
Registered Person / Authorized Representative	Legal Representative (`Authorized Signatory`)	Recorded authority to bind or represent the company
Company Secretary	Other Key Person	Statutory officer but no legal representation authority
Electronic Filing Agent	Other Key Person	Authority for CRO filings; this appointment alone does not establish general signing powers
Business Name Owner	Legal Representative	Registered owner of a business name (`-B` id), individual or company

Known source titles have fixed English meanings and standardized roles. The Company Printout is extracted using AI, and unlisted titles retain that fallback. Classification also uses the source context: under Companies Act 2014 sections 39–40, authority of the board as a body does not establish individual authority for every director. A director with a recorded individual grant is returned as a legal representative; an office-only director is a key person. Source signing restrictions are retained when present; absent powers do not imply sole or joint representation.Both individuals and companies can hold roles. Electronic Filing Agents are typically companies (e.g., accountancy firms), while directors and secretaries are typically individuals.

Registered business names (-B ids) have no directors or secretary. Their registered owner(s), individual or company, are read from the CRO Business Name Profile and returned under legalRepresentatives with the standardized role Owner. otherKeyPersons is empty for business names.

Other Key Persons

Role	English Translation	Notes
Company Secretary	Secretary	Statutory officer required by Irish law
Electronic Filing Agent	Electronic Filing Agent	Authorized agent for electronic CRO submissions
Persons authorised to accept service of process	Agent for Service of Process	Service function, not general signing authority
Persons responsible for ensuring compliance details	Person Responsible for Compliance	Compliance function, not general signing authority

Shareholders

Shareholders are AI-extracted from the most recent annual return filed with the CRO. The Form B1C (Annual Return with Accounts) is preferred, then a plain Form B1, then a Form B1C3. This is conceptually similar to the German approach of extracting shareholders from filed documents rather than structured registry data. Extraction process:

Fetch available documents and keep the annual returns that cover a recent period (within 2 years of the current year)
Pick the newest B1C; if there is none, the newest B1; if there is none, the newest B1C3
Retrieve and download the annual return from CRO Core
Extract the text from the filing
Parse shareholders using AI

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:

[
  {
    "entityId": "company_001",
    "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)"
  },
  {
    "entityId": "company_002",
    "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 eligible annual return is used; historical ownership changes are not tracked
Annual return age limit	Must cover at most current year minus 2 (e.g., 2024+ in 2026). When no B1C, B1, or B1C3 is recent enough, shareholders are empty
Active companies only	Only companies with Active, Under Insolvency Proceeding, or Unknown status
Business names	Not applicable: requesting `shareholders` for a `-B` id returns `datapoint_not_applicable`
AI extraction quality	Best-effort reconstruction from document text; complex multi-column layouts may affect accuracy
Document retrieval	The annual return is retrieved automatically; you do not need to order it first

Activity Code Mapping

CRO Open Data supplies a declared NACE Rev. 2 class where one is recorded. It is returned under company.activities.NACE_REV2, with its official English description in company.activityDescription. The original classification is preserved; the code is also converted to NACE Rev. 2.1 under NACE and to ISIC Rev. 5 under ISIC using official correspondence tables. These codes carry isAIInferred: false. When a Rev. 2 class splits into several Rev. 2.1 classes, the response uses the common parent supported by the declared code. It does not report every possible successor as a separate registered activity.

{
  "activityDescription": "Computer programming activities",
  "activities": {
    "NACE_REV2": [{ "code": "62.01", "description": "Computer programming activities", "isMainActivity": true, "isAIInferred": false }],
    "NACE": [{ "code": "62.10", "isMainActivity": true, "isAIInferred": false }],
    "ISIC": [{ "code": "621", "isMainActivity": true, "isAIInferred": false }]
  }
}

The declared classification comes from a periodically refreshed dataset in both prefill and verification modes. It may be absent or older than the live company profile. Registered business names (-B ids) are excluded from this dataset and do not inherit the activity of a company with the same number.

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); owners of business names from the Business Name Profile
Other Key Persons	Yes	Async	Secretaries and filing agents from Company Printout
Shareholders	Yes	Async	AI-extracted from the latest annual return (B1C, B1, or B1C3). Not applicable to business names
Establishments	No	-	CRO does not provide branch/establishment data
Activity Codes	When recorded	Sync	Declared NACE Rev. 2 from CRO Open Data, with formal NACE Rev. 2.1 and ISIC Rev. 5 conversions
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 and organized into three categories: documents (filings), certificates, and reports.

Document Type	API Category	Format	Description
Company Printout	`tradeRegisterExtract`	PDF	Current company details from registry (no financial accounts)
Business Name Profile	`tradeRegisterExtract`	PDF	Registration details of a business name (`-B` id), including the registered owner(s)
Financial Statements	`financialStatements[]`	PDF	Annual accounts, auditor reports, account details
Company Constitution	`articlesOfAssociation[]`	PDF	Constitutional documents defining governance rules
B1C Annual Return	`otherDocuments[]`	PDF	Annual return with accounts (preferred shareholder data source)
B1 Annual Return	`otherDocuments[]`	PDF	Annual return without accounts (shareholder data source when no recent B1C exists)
B10 Director/Secretary Changes	`otherDocuments[]`	PDF	Director or secretary appointment/resignation filings
Charge Documents (C1, C2, C6, C17)	`otherDocuments[]`	PDF	Mortgage/charge creation, satisfaction, and updates
Share Capital (B5, B7)	`otherDocuments[]`	PDF	Share allotments and capital structure changes
Resolutions (G1, G2)	`otherDocuments[]`	PDF	Special and ordinary shareholder resolutions
A1 Incorporation	`otherDocuments[]`	PDF	Original application to register as a new company
Letter of Status	`otherDocuments[]`	PDF	Official letter confirming company current status. Delivered about one business day after the order
Certificates	`otherDocuments[]`	PDF	Charge certificates, name change certificates, etc.

Document pricing varies by document type. See the pricing page for current prices. Requesting legalRepresentatives or otherKeyPersons includes the Company Printout (or the Business Name Profile for a business name) at no extra charge, and requesting shareholders includes the B1C annual return when that is the filing the shareholders were read from.

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": "<id>", "countryCode": "IE", "dataPoints": ["company", "legalRepresentatives", "otherKeyPersons"] }

Active Private Limited Company (LTD)

{
  "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": "Private Company Limited by Shares",
      "standardized": "Limited Liability Company",
      "iso20275Code": "MNQ7"
    },
    "legalAddress": {
      "addressLine1": "15 Fitzwilliam Square",
      "city": "Dublin",
      "postalCode": "D02 XY12",
      "countryCode": "IE"
    }
  },
  "legalRepresentatives": [],
  "otherKeyPersons": [
    {
      "entityId": "person_001",
      "type": "individual",
      "role": {
        "localName": "Director",
        "standardized": "Board Member",
        "englishTranslation": "Director"
      },
      "individual": {
        "name": {
          "fullName": "John Murphy",
          "firstName": "John",
          "lastName": "Murphy"
        }
      }
    },
    {
      "entityId": "person_002",
      "type": "individual",
      "role": {
        "localName": "Director",
        "standardized": "Board Member",
        "englishTranslation": "Director"
      },
      "individual": {
        "name": {
          "fullName": "Mary O'Brien",
          "firstName": "Mary",
          "lastName": "O'Brien"
        }
      }
    },
    {
      "entityId": "person_003",
      "type": "individual",
      "role": {
        "localName": "Secretary",
        "standardized": "Secretary"
      },
      "individual": {
        "name": {
          "fullName": "Patrick Kelly",
          "firstName": "Patrick",
          "lastName": "Kelly"
        }
      }
    },
    {
      "entityId": "company_001",
      "type": "company",
      "role": {
        "localName": "Electronic Filing Agent",
        "standardized": "Other"
      },
      "company": {
        "legalName": "Dublin Accountancy Services Ltd"
      }
    }
  ]
}

Active Public Limited Company (PLC)

{
  "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": "Public Limited Company",
      "standardized": "Corporation",
      "iso20275Code": "VYAX"
    },
    "legalAddress": {
      "addressLine1": "42 Fitzwilliam Square",
      "city": "Dublin 2",
      "postalCode": "D02 R279",
      "countryCode": "IE"
    }
  },
  "legalRepresentatives": [],
  "otherKeyPersons": [
    {
      "entityId": "person_001",
      "type": "individual",
      "role": {
        "localName": "Director",
        "standardized": "Board Member",
        "englishTranslation": "Director"
      },
      "individual": {
        "name": {
          "fullName": "Sean Fitzgerald",
          "firstName": "Sean",
          "lastName": "Fitzgerald"
        }
      }
    },
    {
      "entityId": "person_002",
      "type": "individual",
      "role": {
        "localName": "Director",
        "standardized": "Board Member",
        "englishTranslation": "Director"
      },
      "individual": {
        "name": {
          "fullName": "Aoife Byrne",
          "firstName": "Aoife",
          "lastName": "Byrne"
        }
      }
    },
    {
      "entityId": "company_001",
      "type": "company",
      "role": {
        "localName": "Secretary",
        "standardized": "Secretary"
      },
      "company": {
        "legalName": "Corporate Services Ireland Ltd"
      }
    }
  ]
}

Closed Company (Struck Off)

{
  "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",
      "englishTranslation": "Private Company Limited by Shares",
      "standardized": "Limited Liability Company",
      "iso20275Code": "MNQ7"
    },
    "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.

Company Under Insolvency (Liquidation)

{
  "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": "Company Limited by Guarantee",
      "standardized": "Limited Liability Company",
      "iso20275Code": "C58S"
    },
    "legalAddress": {
      "addressLine1": "13 City Quay",
      "city": "Dublin 2",
      "postalCode": "D02 ED70",
      "countryCode": "IE"
    }
  },
  "legalRepresentatives": [],
  "otherKeyPersons": [
    {
      "entityId": "person_001",
      "type": "individual",
      "role": {
        "localName": "Director",
        "standardized": "Board Member",
        "englishTranslation": "Director"
      },
      "individual": {
        "name": {
          "fullName": "Ciaran Walsh"
        }
      }
    }
  ]
}

Shareholders Response (from B1C Annual Return)

Query with "dataPoints": ["shareholders"]:

{
  "shareholders": [
    {
      "entityId": "company_001",
      "type": "company",
      "sharePercentage": 100,
      "numberOfShares": 2,
      "nominalCapitalHeld": { "amount": 2.54, "currency": "EUR" },
      "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.

Available Documents Response

Documents are returned when "dataPoints": ["availableDocuments"] is requested.

{
  "documents": {
    "tradeRegisterExtract": {
      "id": "f61acfca-9b34-52a7-b4f2-41c652f91394",
      "name": "Company Printout",
      "description": "Current company details from registry - does not include financial accounts",
      "format": "pdf"
    },
    "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"
      }
    ],
    "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"
      }
    ],
    "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"
      },
      {
        "id": "c9ed0cc7-aa0a-5831-b50b-b5797e2af8d7",
        "name": "Letter of status - Companies",
        "description": "Official letter confirming company current status",
        "format": "pdf"
      }
    ]
  }
}

Note: Document names include the CRO submission reference in parentheses (e.g., SR371822). Descriptions include filing and effective dates when available. Each document also carries a price in credits; see the pricing page for current document prices.

Prefill Profile (Source: Fast search data)

{
  "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", "englishTranslation": "Public Limited Company", "standardized": "Corporation", "iso20275Code": "VYAX" },
    "legalAddress": { "addressLine1": "42 FITZWILLIAM SQUARE", "postalCode": "D02R279", "countryCode": "IE" }
  }
}

Note: Prefill profiles are served from the fast search source (business names are read live from the CRO). For known CRO type codes, the legal form carries the same englishTranslation, standardized, and iso20275Code as in verification mode. No shareholders. Declared activity codes are included where recorded in CRO Open Data.

​Start here

Ireland coverage, pricing, and sources

​Table of Contents

​Data Sources

​Data Source Priority & Routing

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Legal Entity Identifier (LEI)

​Search Capabilities

​Active companies only

​Fast search data

​Search

​Companies in fast search data

​Prefill Mode

​Quirks & Gotchas

​Statutory Filings

​Mappings

​Company Status

​Legal Forms

​Business Names

​Limited Companies

​Designated Activity Companies

​Unlimited Companies

​Guarantee Companies

​Partnerships

​Investment Companies

​European Companies (Societas Europaea)

​Foreign / Branch / Other

​Legal Representatives

​Other Key Persons

​Shareholders

​Activity Code Mapping

​Data Availability

​Data Availability Matrix

​Documents by Company Type

​Example API Responses

Start here

Table of Contents

Data Sources

Data Source Priority & Routing

Company Identifiers

Query Identifiers

Identifiers in API Response

Legal Entity Identifier (LEI)

Search Capabilities

Active companies only

Fast search data

Search

Companies in fast search data

Prefill Mode

Quirks & Gotchas

Statutory Filings

Mappings

Company Status

Legal Forms

Business Names

Limited Companies

Designated Activity Companies

Unlimited Companies

Guarantee Companies

Partnerships

Investment Companies

European Companies (Societas Europaea)

Foreign / Branch / Other

Legal Representatives

Other Key Persons

Shareholders

Activity Code Mapping

Data Availability

Data Availability Matrix

Documents by Company Type

Example API Responses