# Companies Registration Office Ireland — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/cro-ireland/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/cro-ireland/get-gazette-issue \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/cro-ireland/get-gazette-list-by-year \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/cro-ireland/get-gazette-years \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/cro-ireland/get-latest-gazette \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.