# Croa — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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.paywithlocus.com/api/wrapped/parse-croa-com-api-77824889/filter_awards_by_party \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-croa-com-api-77824889/get_award_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-croa-com-api-77824889/get_awards_by_range \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-croa-com-api-77824889/get_awards_index \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-croa-com-api-77824889/get_home \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-croa-com-api-77824889/get_latest_awards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-croa-com-api-77824889/get_members \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-croa-com-api-77824889/search_awards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```