Skip to main content

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

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

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

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

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

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 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:
  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: 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:
Limitations:

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.
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": "<id>", "countryCode": "IE", "dataPoints": ["company", "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.
Query with "dataPoints": ["shareholders"]:
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.
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.
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.