In development

API documentation

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

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

Quick start

curl "https://search.registerlens.ie/api/search?q=transfermate"

Searching, looking up a firm and reading registers work without a key. A machine-readable description is at /api/openapi.json.

Keys and limits

Without a keyFree keySearch creditsPro
Per IP address10 requests a minute10 requests a minute, shared with keyless callsNo limitNo limit
Per key100 requests a dayOne credit per call10,000 a day included, then metered
Search results per call10100100100
Register entries per call251,0001,0001,000
Change feed and CSV exportsNoDuring developmentDuring developmentYes

Daily allowances reset at midnight UTC. To get a free key, sign in with Google, LinkedIn or Apple and create one 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; calls paid with search credits carry X-Credits-Remaining. What each plan costs is on the pricing page.

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.
/api/firms/{id}
One firm: every registration, other names and its change history.
/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 (ISO date or date-time), 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. Current entries only unless include_removed=true.
/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, 403 for a Pro feature on a free key, 404 when nothing matches, and 429 when over a limit (per-IP limits add a Retry-After header).