API documentation

The register data as JSON and CSV. Read-only, plain HTTPS, no SDK needed.

On this page: Quick start · Keys and limits · Endpoints · Reading the data · Errors. Plans and prices are on the pricing page.

Quick start

Base URL: https://search.registerlens.ie/api. Every endpoint is a GET that returns JSON, except the CSV exports.

curl -H "X-API-Key: cbi_your_key" "https://search.registerlens.ie/api/search?q=transfermate"

Every call needs a key with search credit or Pro (see Keys and limits); looking firms up on this website is free. A machine-readable description is at /api/openapi.json.

Keys and limits

Search creditsPro
Price€0.05 a call, paid upfront (€20 to €2,000 of credit)€75 a week, €240 a month or €2,400 a year
LimitsOne credit per call; no daily or per-minute limit10,000 a day included, then metered; no per-minute limit
Search results per call100100
Register entries per call1,0001,000
Change feed and CSV exportsYes, until launchYes
History: firm timelines and as_ofYes, until launchYes
New entrants and exits (/api/moves)Yes, until launchYes

There is no free tier: a call without a key, or with a key that has neither credit nor Pro, is refused. To get a key, log in with Google, LinkedIn or Apple, buy credits or Pro and create a key on your account page. Send it in a header:

curl -H "X-API-Key: cbi_your_key" "https://search.registerlens.ie/api/changes?since=2026-11-01"

Never put a key in a URL: requests with ?api_key= are refused. Keyed responses carry X-RateLimit-Limit and X-RateLimit-Remaining on Pro (daily allowances reset at midnight UTC); calls paid with search credits carry X-Credits-Remaining.

Endpoints

/api/search?q=
Firms matching a name, trading name, CBI reference (C42802 or 42802) or register number, best first. Also register (a register slug), historic=true (include firms no longer listed), limit, offset. warnings lists Central Bank warnings about unauthorised firms with a similar name (clones of real firms among them).
/api/firms/{id}
One firm: every registration, other names and its change history; its LEI, parent companies and the other regulated firms in its group (group); Central Bank enforcement actions and clone warnings (notices).
/api/firms/by-reference/{C-number}
The same, looked up by CBI reference.
/api/registers
Every register with its slug, entry count and the date the Central Bank printed on it.
/api/registers/{slug}
One register.
/api/registers/{slug}/firms
The entries on one register. sort=name|ref|date, include_removed=true, limit, offset.
/api/changes key
Additions, removals, reinstatements and renames, newest first. since and until (ISO date or date-time; a plain until date includes that day), type=added|removed|reinstated|renamed, register, limit (up to 1,000), offset.
/api/export/{slug}.csv, /api/export/all.csv key
A whole register, or every register, as CSV with a header row, including each firm's LEI and the head of its group. Current entries only unless include_removed=true.
/api/moves key
New entrants and exits, newest first: authorisations (by the date the register prints), first listings, removals, and companies dissolved, struck off or in liquidation at the CRO, each with its CRO number, NACE code, LEI and group. since, until (default the last 90 days), direction=entrant|exit, kind, register, category, format=csv. Also on the site: New entrants.
/api/firms/{id}/history, /api/firms/by-reference/{C-number}/history key
One dated timeline per firm, newest first: additions, removals and renames on each register, the authorisation dates the registers print, and the matched company's CRO status, name and address changes, incorporation and dissolution.
as_of=YYYY-MM-DD key
On /api/firms/{id}, /api/registers/{slug}/firms and the CSV exports: the entries as listed at the end of that day. History is recorded from RegisterLens's first load onwards, because the Central Bank and the CRO publish only today's data; earlier dates are refused with the start date.
/api/health
Whether the service is up, and the date of the latest data.

Reading the data

Errors

Errors are JSON, {"error": "…"}, with the HTTP status: 400 for a bad parameter, 401 for a missing, unknown or revoked key, 402 when the key has no search credit left and no Pro, 403 for a Pro feature on a credit key, 404 when nothing matches, and 429 when a Pro key is over its daily allowance.