# Companies Registration Office Ireland — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access Irish company statutory filings and registration documents by browsing CRO Gazette archives and retrieving PDFs for new company registrations, annual returns, and other official filings. Find gazette issues by year and get links to the latest published documents from the Companies Registration Office.

**Category:** Government & Public Data | **Website:** [cro.ie/](https://cro.ie/) | **Docs:** [parse.bot/marketplace/bfea662e-8bef-4036-aabd-c2933709f8dd/cro-ie-api](https://parse.bot/marketplace/bfea662e-8bef-4036-aabd-c2933709f8dd/cro-ie-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-cro-ie-api-bfea662e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_gazette_issue

Get PDF report links for a specific gazette issue. Returns a list of report names and their PDF download URLs for the given issue page. Each issue typically contains multiple reports covering new companies, annual returns, strike-offs, and other statutory filings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `issue_url` | string | Yes | Full URL of the gazette issue page, as returned by get_gazette_list_by_year or get_latest_gazette (e.g. 'https://cro.ie/cro-gazette-publications/cro-gazette-10-june-2026/'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cro-ie-api-bfea662e/get_gazette_issue \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issue_url":"<string>"}'
```

### get_gazette_list_by_year

Get list of gazette issues for a specific year. Returns individual gazette issues with titles and URLs. Works reliably for recent years; some older years listed in get_gazette_years may return an empty issues array if the site does not have structured issue links for that year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | Yes | 4-digit year (e.g. '2025'). Available years can be retrieved from get_gazette_years. Valid range is 2004 to the current year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cro-ie-api-bfea662e/get_gazette_list_by_year \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### get_gazette_years

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.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cro-ie-api-bfea662e/get_gazette_years \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_latest_gazette

Find and return the most recent gazette issue and its report PDF links. Automatically determines the latest year and latest issue, then returns the same structure as get_gazette_issue. Useful for monitoring new company registrations without needing to know the current issue URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cro-ie-api-bfea662e/get_latest_gazette \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```