Public API
Programmatic access to the directory. Free, no API key, JSON over HTTPS.
Get a company by CRO number
GET /api/v1/companies/{cro_number}Try it:
curl -s https://every-company-ever.com/api/v1/companies/355213Example response (summary is null for companies that have not yet been enriched):
{
"cro_number": 355213,
"name": "HOGS & HEIFERS UNLIMITED COMPANY",
"status": "NORMAL",
"summary": "Hogs & Heifers Unlimited Company is a company classified under NACE 64.20, which includes activities such as the wholesale of meat and meat products.",
"registered_county": "Dublin",
"incorporation_date": "2002-04-03",
"legal_type": "ULC - Private Unlimited Company"
}status values match the raw CRO status codes: NORMAL for active companies and DISSOLVED for struck-off ones. legal_type is the verbatim CRO legal-form string (e.g. LTD - Private Company Limited by Shares).
Status codes
200 OK— company found, JSON body returned.404 Not Found— no such CRO number in the register.429 Too Many Requests— rate limit hit (see below).503 Service Unavailable— temporary backend issue; retry with backoff.
Authentication
None. The endpoint is open. If you build something on top of it, a link back to every-company-ever.com is appreciated but not required.
Rate limits
Soft cap of 60 requests/minute per IP on a best-effort
basis — well above what any reasonable integration needs. Exceeding it
returns 429 with a Retry-After header. If you need
to pull thousands of records, prefer Bulk download
or email us for a one-off export.
Sitemap
The complete URL list for crawlers and bulk-discovery lives in /sitemap.xml (master) and per-county sub-sitemaps.
Roadmap
A wider v2 surfacing search, listings, and filters is planned. For now, the canonical detail-page URL is the most reliable integration point — it remains stable across re-classifications and never 404s once issued.