# TAB Australia — 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 live horse racing meetings, race cards, fixed odds, and results from TAB Australia. Retrieve real-time sports betting information and racing data, including upcoming races, current odds, and historical race outcomes.

**Category:** Sports | **Website:** [tab.com.au/](https://tab.com.au/) | **Docs:** [parse.bot/marketplace/eb8e0df6-b373-4440-bc66-cbd2a0c0d645/tab-com-au-api](https://parse.bot/marketplace/eb8e0df6-b373-4440-bc66-cbd2a0c0d645/tab-com-au-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-tab-com-au-api-eb8e0df6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_next_to_jump_races

Retrieve the next races to jump across all venues and race types.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tab-com-au-api-eb8e0df6/get_next_to_jump_races \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_race_card

Retrieve full race card/details for a specific race.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Race date (YYYY-MM-DD) |
| `race_number` | integer | Yes | Race number |
| `race_type` | string | Yes | Race type (thoroughbred, harness, greyhound) |
| `venue` | string | Yes | Venue name slug |
| `venue_code` | string | Yes | Venue code |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tab-com-au-api-eb8e0df6/get_race_card \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","race_number":"<integer>","race_type":"<string>","venue":"<string>","venue_code":"<string>"}'
```

### get_race_fixed_odds

Retrieve current fixed odds for a specific race.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Race date (YYYY-MM-DD) |
| `race_number` | integer | Yes | Race number |
| `race_type` | string | Yes | Race type |
| `venue` | string | Yes | Venue name slug |
| `venue_code` | string | Yes | Venue code |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tab-com-au-api-eb8e0df6/get_race_fixed_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","race_number":"<integer>","race_type":"<string>","venue":"<string>","venue_code":"<string>"}'
```

### get_race_results

Retrieve final results for a completed race.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Race date (YYYY-MM-DD) |
| `race_number` | integer | Yes | Race number |
| `race_type` | string | Yes | Race type |
| `venue` | string | Yes | Venue name slug |
| `venue_code` | string | Yes | Venue code |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tab-com-au-api-eb8e0df6/get_race_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","race_number":"<integer>","race_type":"<string>","venue":"<string>","venue_code":"<string>"}'
```

### get_racing_meetings_by_date

Retrieve all racing meetings for a given date across all race types.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format. Defaults to today. |
| `jurisdiction` | string | No | State jurisdiction code (NSW, VIC, QLD, etc.) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tab-com-au-api-eb8e0df6/get_racing_meetings_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","jurisdiction":"<string>"}'
```
