CRO APIcro.ie ↗
Access CRO Gazette archives from 2004 to present. Browse gazette issues by year, retrieve PDF links for new company registrations, strike-offs, and annual returns.
What is the CRO API?
The CRO Gazette API provides 4 endpoints for accessing the Irish Companies Registration Office Gazette archive, covering issues from 2004 to the present. Use get_gazette_years to enumerate available years, get_gazette_list_by_year to retrieve individual issues for a given year, and get_gazette_issue or get_latest_gazette to pull direct PDF download URLs for reports covering new company registrations, annual returns, strike-offs, and other statutory filings.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/30638c6e-606b-455c-bd09-e1f712478acb/get_gazette_years' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace cro-ie-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Irish CRO Gazette SDK — browse gazette archives and retrieve PDF report links."""
from parse_apis.irish_cro_gazette_api import CROGazette, ResourceNotFound
client = CROGazette()
# List available gazette years (full archive from 2004 to present)
for year in client.gazetteyears.list(limit=5):
print(year.year, year.url)
# Drill into a specific year's issues via constructible resource
year_2025 = client.gazetteyear(year="2025")
issue = year_2025.issues.list(limit=1).first()
# Get PDF reports for the first issue found
if issue:
for report in issue.reports(limit=3):
print(report.report_name, report.pdf_url)
# Retrieve the latest gazette issue directly
try:
latest = client.gazetteissues.latest()
print(latest.issue_url)
for r in latest.reports[:3]:
print(r.report_name, r.pdf_url)
except ResourceNotFound as exc:
print(f"not found: {exc}")
print("exercised: gazetteyears.list / year.issues.list / issue.reports / gazetteissues.latest")
Get list of years for which CRO Gazettes are available. Returns years from 2004 to the present, each with a URL to the year's gazette category page. No pagination — the full list is returned in one response.
No input parameters required.
{
"type": "object",
"fields": {
"years": "array of GazetteYear objects with year and url"
},
"sample": {
"data": {
"years": [
{
"url": "https://cro.ie/cro-gazette-category/2026-gazette/",
"year": "2026"
},
{
"url": "https://cro.ie/cro-gazette-category/2025-gazette/",
"year": "2025"
},
{
"url": "https://cro.ie/cro-gazette-category/2024-gazette/",
"year": "2024"
}
]
},
"status": "success"
}
}About the CRO API
Gazette Archive Navigation
get_gazette_years returns an array of objects, each containing a year string and a url pointing to that year's gazette category page. Coverage runs from 2004 through the current year. Pass any of those year values as the year parameter to get_gazette_list_by_year, which returns an issues array where each entry has a title (e.g. "Gazette Issue – 22 April 2026") and a url to the individual issue page. Note that some older years may return an empty issues array if structured issue links are not available for that period.
Retrieving PDF Report Links
get_gazette_issue accepts an issue_url — typically sourced from get_gazette_list_by_year — and returns a reports array. Each report object contains a report_name (e.g. "22 April 2026 – New Companies Report") and a pdf_url pointing directly to the downloadable PDF. A single gazette issue typically bundles multiple report types: new company registrations, annual returns, strike-offs, and other statutory notices.
Monitoring the Latest Issue
get_latest_gazette requires no inputs. It automatically resolves the current year, identifies the most recent gazette issue, and returns the same reports and issue_url structure as get_gazette_issue. This is the most direct route for workflows that only need the newest filings without first calling get_gazette_years or get_gazette_list_by_year.
The CRO API is a managed, monitored endpoint for cro.ie — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cro.ie changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official cro.ie API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new Irish company registrations weekly by polling
get_latest_gazettefor the newest New Companies Report PDF - Build a historical archive of CRO Gazette PDFs by iterating
get_gazette_list_by_yearacross all years returned byget_gazette_years - Track companies at risk of dissolution by downloading and parsing strike-off report PDFs from
get_gazette_issue - Alert compliance teams when a specific company name appears in a new annual returns gazette
- Aggregate gazette issue metadata (titles and URLs) for a searchable internal index of statutory filings since 2004
- Automate due-diligence workflows by fetching PDF links for recent gazette issues and feeding them to document parsers
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Companies Registration Office provide an official developer API?+
What report types does a single gazette issue contain?+
get_gazette_issue returns a reports array where each object has a report_name and pdf_url. A single issue typically includes separate reports for new company registrations, annual returns filed, strike-off notices, and other statutory filings. The exact report names vary by issue date.Are gazette issues available for all years from 2004 onwards?+
get_gazette_years reliably returns year entries from 2004 to the present, but calling get_gazette_list_by_year on some older years may return an empty issues array. Structured issue links are more consistently available for recent years.Can I search gazette PDFs for a specific company name through the API?+
report_name strings and pdf_url direct links; it does not parse or index the PDF contents. You can fork the API on Parse and revise it to add a PDF text-extraction endpoint that searches for company names within the returned documents.