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.
Table of Contents
- 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. 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:- Company Profile — Live query to the CRO Public API (
services.cro.ie) - Legal Representatives & Other Key Persons — AI-extracted from the Company Printout document (retrieved from CRO Core)
- Shareholders — AI-extracted from the most recent B1C Annual Return document (retrieved from CRO Core)
- Documents — Listed and retrieved from CRO Core (
core.cro.ie)
Company Identifiers
Query Identifiers
Identifiers in API Response
Search Capabilities
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.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:
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 thecompany 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
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-countrystatutoryFilings 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.
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.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 numericcompany_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
Designated Activity Companies
Unlimited Companies
Guarantee Companies
Partnerships
Investment Companies
European Companies (Societas Europaea)
Foreign / Branch / 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.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
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:- Fetch available documents and find the most recent B1C form
- Verify the B1C covers a recent period (within 2 years of the current year)
- Retrieval and download the B1C document from CRO Core
- OCR the PDF using Mistral OCR
- Parse shareholders using AI (racing multiple models for speed)
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:
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
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.
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"] }
Active Private Limited Company (LTD)
Active Private Limited Company (LTD)
Active Public Limited Company (PLC)
Active Public Limited Company (PLC)
Closed Company (Struck Off)
Closed Company (Struck Off)
closureDate is populated from the CRO status date when the company’s status is CLOSED.Company Under Insolvency (Liquidation)
Company Under Insolvency (Liquidation)
Available Documents Response
Available Documents Response
Documents are returned when Note: Document names include the CRO submission reference in parentheses (e.g.,
"dataPoints": ["availableDocuments"] is requested.SR371822). Descriptions include filing and effective dates when available. Prices are in EUR.Onboarding Profile (Source: Fast search data)
Onboarding Profile (Source: Fast search data)
standardized or iso20275Code on legal form, no shareholders, no activity codes.