---
title: "Canonical venue directory"
method: GET
path: "/v1/racing/venues"
tags: ["Racing"]
---

# Canonical venue directory

`GET /v1/racing/venues`

## Request

- Base URL: `https://api.puntersedge.online`
- URL: `https://api.puntersedge.online/v1/racing/venues`
- Auth: API key in header `X-API-Key`

Cost: 1 credit. Every venue this API has actually served recently, with its canonical
identity — built for joining our data against official sources (Racing Australia, form
guides) that spell venues differently from bookmakers.

THE LIST IS MEASURED, the identity is curated. Rows come from the live race window plus
the trailing 60 days of results — a venue appears because races actually ran there, so
the directory can never advertise coverage that does not exist. Each observed spelling is
then resolved by the same registry that stamps venue_id / venue_canonical / venue_site on
every racing response, so this endpoint and those fields can
never disagree.

`venue_site` is the join key for multi-track complexes: Sandown, Sandown Hillside,
Sandown Lakeside and the Sandown Park greyhound track all carry site "sandown";
Q Straight / Q1 Lakeside / Q2 Parklands carry "the-q". `spellings` lists the raw venue
strings observed under each id, so you can map historical data you have already stored.

## Headers

- `X-API-Key` string
- `X-RapidAPI-Proxy-Secret` string

## Response `200`

Successful Response

- VenueOut[]
  - `venue_id` string, required
  - `venue_canonical` string, nullable, required
  - `venue_site` string, nullable, required
  - `country` string, nullable, required
  - `categories` string[], required
  - `spellings` string[], required

## Other responses

- `401`: Missing or invalid API key. Send `X-API-Key`. See https://puntersedge.online/developers/errors
- `402`: Monthly credit allowance exhausted for this plan. Upgrade at https://puntersedge.online/api/pricing
- `422`: Validation Error
- `429`: Rate limit exceeded for this plan. Honour the `Retry-After` header (seconds) before retrying. See https://puntersedge.online/developers/rate-limits
- `500`: Unexpected server error. Safe to retry with backoff.

---

[API](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api.md) · [All operations](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/revisions/f35b6aab1946?raw)