Irish company registry API (CRO Open Data)

GET/v1/eu/entreprise/IE/{numero}

Price: $0.01
Free quota: Included
Family: Europe · search and profiles

Parameters
Parameter	Where	Example
`numero`	path · required	`600161`

What is charged

200Ed25519-signed response, charged at the route's price
402Signed x402 quote, nothing is debited
4xxUnknown or invalid identifier, never charged
5xxUpstream source unavailable, never charged

See the reconstructed example (free) Get the quote for /v1/eu/entreprise/IE/{numero}

curlx402MCPPythonJS

curl "https://api.sirenic.eu/v1/eu/entreprise/IE/600161" \
  -H "X-Api-Key: $SIRENIC_KEY"

# 1. The quote, without paying anything: the route answers 402 with its amount
curl -i "https://api.sirenic.eu/v1/eu/entreprise/IE/600161"

# 2. The paid call: the x402 client settles the quote and replays the request
npx x402-fetch "https://api.sirenic.eu/v1/eu/entreprise/IE/600161"

# Or over MCP, in Claude Code / Cursor / an agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

import os, requests

r = requests.get(
    "https://api.sirenic.eu/v1/eu/entreprise/IE/600161",
    headers={"X-Api-Key": os.environ["SIRENIC_KEY"]},
)
print(r.json())

const r = await fetch("https://api.sirenic.eu/v1/eu/entreprise/IE/600161", {
  headers: { "X-Api-Key": process.env.SIRENIC_KEY },
});
console.log(await r.json());

200 OK · extractx-credits-charged: 0.01

{
 "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": null,
  "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"
    }
   ]
  }
 }
}

Dated snapshot from 2026-09-18, reconstructed example, not a paid response (composed by hand or read from the code), truncated by removal, some arrays keeping several items. It is not live data. The full extract is served free of charge from the samples surface, and the schema from the OpenAPI document.

Full reconstructed example, not a paid response ↗

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, examinership…), 45 type codes, annual-return dates, last accounts, NACE, 2022-2024 filings index. 404 without charge if absent or of unknown type.

Expected identifier

CRO number, 1 to 7 digits (IE prefix tolerated), e.g. 600161. An unknown CRO type is refused (404, not billed).

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.

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.

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 CRO publishes no city: the common identity's city is read from the last address line, null when it only gives a county or an Eircode; 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, two ways, with no subscription: over x402, in USDC or EURC on the Base network, with no account and no API key; or with the API key of an account, which opens the free quota. Over x402, the first call returns a 402 quote your client settles, then replays the call. A failed call is never billed.

Open today: 150 free calls a month with an account, on 123 of 129 routes (the price list says which), and pay-per-call over x402 (USDC or EURC), with no account except registry filings. Prepaid credits: card top-up is not open yet.

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 and in llms.txt.

One call, end to end

# x402 client (npm): the 402 quote is settled and the call replayed automatically
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Or over MCP, in Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

Routes used and pricing

Route	Price	Sample	What it returns
`/v1/eu/entreprise/IE/{numero}`	$0.01	free sample	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, examinership…), 45 type codes, annual-return dates, last accounts, NACE, 2022-2024 filings index. 404 without charge if absent or of unknown type.

Take it further

The first step is free and shows you exactly what you would be buying, with no account or key; an account, with its API key, then opens the free quota.

See the reconstructed example (free) Get the quote for /v1/eu/entreprise/IE/{numero} Create an account: 150 free calls a month

Irish company file