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 key | Free key | Search credits | Pro | |
|---|---|---|---|---|
| Per IP address | 10 requests a minute | 10 requests a minute, shared with keyless calls | No limit | No limit |
| Per key | 100 requests a day | One credit per call | 10,000 a day included, then metered | |
| Search results per call | 10 | 100 | 100 | 100 |
| Register entries per call | 25 | 1,000 | 1,000 | 1,000 |
| Change feed and CSV exports | No | During development | During development | Yes |
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 (
C42802or42802) or register number, best first. Alsoregister(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/changeskey- 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.csvkey- 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
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, 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).