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 credits | Pro | |
|---|---|---|
| Price | €0.05 a call, paid upfront (€20 to €2,000 of credit) | €75 a week, €240 a month or €2,400 a year |
| Limits | One credit per call; no daily or per-minute limit | 10,000 a day included, then metered; no per-minute limit |
| Search results per call | 100 | 100 |
| Register entries per call | 1,000 | 1,000 |
| Change feed and CSV exports | Yes, until launch | Yes |
History: firm timelines and as_of | Yes, until launch | Yes |
New entrants and exits (/api/moves) | Yes, until launch | Yes |
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 (
C42802or42802) or register number, best first. Alsoregister(a register slug),historic=true(include firms no longer listed),limit,offset.warningslists 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/changeskey- Additions, removals, reinstatements and renames, newest first.
sinceanduntil(ISO date or date-time; a plainuntildate includes that day),type=added|removed|reinstated|renamed,register,limit(up to 1,000),offset. /api/export/{slug}.csv,/api/export/all.csvkey- 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/moveskey- 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}/historykey- 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-DDkey- On
/api/firms/{id},/api/registers/{slug}/firmsand 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
list_typesays what being on a list means:authorised,passported_in(authorised in another EEA state),run_off,revokedorother. Revocation and run-off lists are not authorisations.current_authorisation_countcounts only currentauthorisedandpassported_inentries. A firm whose only entry is on a revocation list has 0.- Dates are
YYYY-MM-DD; times are ISO 8601 in UTC. - This is an unofficial copy. Every response carries an
X-Data-Sourceheader; always confirm on the official registers.
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.