# Irish company file

Every day the Companies Registration Office publishes, as open data (CC BY 4.0), the complete snapshot of its register: 824,918 live and dissolved companies on 18/09/2026, with 33 status codes and 45 type codes. This route serves the common identity and the register block: dated status in a closed family, annual returns, last accounts, registered office with Eircode, NACE and the 2022-2024 accounts-filing index.

## What the route returns

Catalogue description, exactly as agents read it:

**Official Irish company registry lookup (Companies Registration Office — CRO Open Data, complete daily snapshot, CC BY 4.0). CRO number, 1-7 digits, e.g. 600161. Common identity (name, type, status, incorporation, registered office with Eircode) plus the CRO block: 33 status codes in closed families (normal, dissolved, liquidation, strike-off, examinership…), 45 type codes, annual-return dates, last accounts, NACE, 2022-2024 filings index (dates). 404 without charge if absent.**

## Expected identifier

**CRO number**, 1 to 7 digits (IE prefix tolerated), e.g. 600161.

> ⚠️ A wrongly formatted identifier in the **path** returns `400` and is **not billed** — but it costs you a round trip. It is the leading cause of failed calls on the foreign routes. A **search** parameter, by contrast, is cleaned up: unsupported characters are stripped and the usable query is served.

## Extract from a genuinely paid response

Dated snapshot from 2026-09-18, truncated to one item per array. It is not live data. The full extract is served **free of charge** from [the samples surface](https://api.sirenic.eu/exemples/), and the schema from the OpenAPI document.

```
{
 "pays": "IE",
 "registre": "Companies Registration Office (CRO)",
 "id_national": "600161",
 "lei": null,
 "denomination": "VOXCITIO LIMITED",
 "forme_juridique": {
  "code": "1153",
  "libelle": "société privée à responsabilité limitée par actions (LTD)"
 },
 "statut": "actif",
 "statut_detail": null,
 "date_creation": "2017-03-09",
 "adresse_siege": {
  "adresse": "74 SOUTH MALL, CO. CORK,CORK, CO. CORK, CORK, IRELAND",
  "code_postal": "T12 F3FD",
  "ville": "CORK",
  "pays": "IE"
 },
 "registre_ie": {
  "statut": "servi",
  "photo": "2026-09-18",
  "numero_registre": "600161",
  "type": {
   "code": "1153",
   "famille": "sarl",
   "fr": "société privée à responsabilité limitée par actions (LTD)"
  },
  "etat": {
   "code": "1151",
   "libelle": "Normal",
   "famille": "normal",
   "fr": "active (normal)",
   "depuis": null
  },
  "procedure_au_registre": false,
  "immatriculee_le": "2017-03-09",
  "dissoute_le": null,
  "declarations_annuelles": {
   "derniere_le": "2025-09-09",
   "prochaine_le": "2026-09-09"
  },
  "derniers_comptes_le": "2025-08-31",
  "siege": {
   "lignes": [
    "74 SOUTH MALL",
    "CO. CORK,CORK",
    "CO. CORK, CORK, IRELAND"
   ],
   "eircode": "T12 F3FD"
  },
  "nace_v2": "62.01",
  "depots_comptes": {
   "statut": "servi",
   "annees": [
    2022,
    2023,
    2024
   ],
   "depots": [
    {
     "exercice_clos_le": "2024-08-31",
     "recu_le": "2024-11-04",
     "soumission": "SR3835963"
    }
   ]
  }
 }
}
```

## Price and billing

Price: **$0.01**. The authoritative amount is the one in the `402` quote returned by the route itself — not this text, which derives from the same grid but is still just a page.

An error response **cancels the payment**: a `400`, `404` or `503` is never billed. An upstream outage closes the route with a `503` rather than serving a degraded response.

## Calling the route

```
# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i https://api.sirenic.eu/v1/eu/entreprise/IE/{numero}

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch https://api.sirenic.eu/v1/eu/entreprise/IE/{numero}

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## What this route does not do

The CRO publishes **no officers, no beneficial owners and no financial figures** as open data: accounts filings are a date index (2022-2024). The locality of the common identity is a heuristic on the last address line; the full registered office is in the block. Daily snapshot: the route is withheld after 7 days without a pass.

## Neighbouring routes

- `/v1/eu/entreprise/IE/{numero}/insolvabilite` — $0.01
- `/v1/eu/entreprise/CY/{id}` — $0.01
- `/v1/eu/entreprise/PL/{id}` — $0.01

## How you pay

Every route is paid **per call**, in USDC or EURC on the Base network, over the x402 protocol: no account to create, no API key, no subscription. The first call returns a `402` quote your client settles, then replays the call. A failed call is never billed.

Would you rather have a euro invoice and prepaid credits? That is **in preparation**, and we will not announce a date until it is open. Write to [contact@sirenic.eu](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs) and we will let you know when it opens.

Paid responses are **Ed25519-signed**: you can later prove what was served to you, and when. The whole catalogue is free to read in the [OpenAPI document](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/llms.txt).

**One call, end to end**

```
# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## Routes used and pricing

| Route | Price | Sample | What it returns |
| --- | --- | --- | --- |
| `/v1/eu/entreprise/IE/{numero}` | $0.01 | [free sample](https://api.sirenic.eu/exemples/eu-entreprise-IE-numero.json) | Official Irish company registry lookup (Companies Registration Office — CRO Open Data, complete daily snapshot, CC BY 4.0). CRO number, 1-7 digits, e.g. 600161. Common identity (name, type, status, incorporation, registered office with Eircode) plus the CRO block: 33 status codes in closed families (normal, dissolved, liquidation, strike-off, examinership…), 45 type codes, annual-return dates, last accounts, NACE, 2022-2024 filings index (dates). 404 without charge if absent. |

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/eu-entreprise-IE-numero.json)
- [Get the quote for /v1/eu/entreprise/IE/{numero}](https://api.sirenic.eu/v1/eu/entreprise/IE/{numero})
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)

## Read next

- [Automating business verification (KYB)](https://api.sirenic.eu/en/use-cases/kyb-automated-business-verification-with-per-block)


Volume figures on this page were measured in our database on 2026-08-19. They are dated snapshots, not live counters.

---

[Home](https://api.sirenic.eu/en) · [Pricing](https://api.sirenic.eu/en/offres) · [Guides](https://api.sirenic.eu/en/articles) · [Routes](https://api.sirenic.eu/en/api) · [Legal notice](https://api.sirenic.eu/mentions-legales) · [Privacy](https://api.sirenic.eu/en/privacy)
