# Croa — 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 Canadian Railway Office of Arbitration awards, search by keywords or date ranges, and retrieve detailed arbitration decisions along with member contact information. Filter results by party involved and get the latest awards to stay current with recent arbitration proceedings.

**Category:** Government & Public Data | **Website:** [croa.com/](https://croa.com/) | **Docs:** [parse.bot/marketplace/77824889-cea3-4679-936b-260340567713/croa-com-api](https://parse.bot/marketplace/77824889-cea3-4679-936b-260340567713/croa-com-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/croa/`
**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

### Filter awards by party

Filter the latest schedule awards by railway company or union name. Performs a case-insensitive search in the description field of the most recent awards page. Useful for finding all recent disputes involving a specific party.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `party` | string | Yes | Party name to filter by (e.g. 'CNR', 'CPKCR', 'TCRC') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/croa/filter-awards-by-party \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"party":"<string>"}'
```

### Get award detail

Retrieve metadata and PDF URL for a specific award by case number. Attempts to extract text content from the PDF and parse structured metadata (parties, subject, arbitrator) from it. Only standard numeric case numbers (e.g. '100', '5204') are supported; suffixed variants will return input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `case_number` | string | Yes | Numeric case number (e.g. '100', '5204'). Only plain numeric IDs are supported. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/croa/get-award-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"case_number":"<string>"}'
```

### Get awards by range

Filter award listings by a numeric case number range. Retrieves the full index and returns only awards whose case number falls within the specified inclusive range. Useful for browsing a specific subset of the 5000+ award database.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_range` | integer | Yes | End of case number range (inclusive) |
| `start_range` | integer | Yes | Start of case number range (inclusive) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/croa/get-awards-by-range \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"end_range":"<integer>","start_range":"<integer>"}'
```

### Get awards index

Retrieve the complete awards index containing all CROA arbitration award PDF links (over 5000 entries from 1965 to present). Each entry includes the case number, display text, and PDF URL. Also returns the available numeric ranges for filtering.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/croa/get-awards-index \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get home

Retrieve navigation links from the CROA English homepage. Returns the page title and a list of primary navigation links (search, latest awards, full index, rules, members, contact).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/croa/get-home \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get latest awards

Retrieve the most recent arbitration awards from the current schedule page. Returns awards with case numbers, hearing dates, dispute descriptions (including parties and subject matter), and PDF URLs. The source URL of the latest awards page is also returned.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/croa/get-latest-awards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get members

Retrieve the list of member railway companies and unions that participate in CROA. Returns organization names and contact details (address information) for each member.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/croa/get-members \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search awards

Search for awards using keywords via the integrated FreeFind search engine. Returns titles, URLs, and text snippets from across the CROA award archive. Results come from the external search index and may include awards from multiple collections (CROA, SHP, Ad Hoc).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword(s) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/croa/search-awards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## 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.