GET /v1/racing/venues

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 (api/venue_registry.py), 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.

Request

curl 'https://api.puntersedge.online/v1/racing/venues' \
  -H 'X-API-Key: YOUR_KEY'

Parameters

This endpoint takes no parameters beyond authentication.

Responses

Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json — this call costs 1 credit. Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

[
  {
    "venue_id": "grafton",
    "venue_canonical": "Grafton",
    "venue_site": "grafton",
    "country": "AU",
    "categories": [
      "horse"
    ],
    "spellings": [
      "GRAFTON",
      "Grafton"
    ]
  },
  {
    "venue_id": "sandown-hillside",
    "venue_canonical": "Sandown Hillside",
    "venue_site": "sandown",
    "country": "AU",
    "categories": [
      "horse"
    ],
    "spellings": [
      "Sandown - HILLSIDE",
      "Sandown Hillside"
    ]
  },
  {
    "venue_id": "sandown-park",
    "venue_canonical": "Sandown Park",
    "venue_site": "sandown",
    "country": "AU",
    "categories": [
      "greyhound"
    ],
    "spellings": [
      "Sandown Park"
    ]
  }
]

Related endpoints

• GET /v1/racing/acceptances — Full-day AU thoroughbred acceptance card: every meeting, race and runner
• GET /v1/racing/best-odds — Best racing price per runner across books
• GET /v1/racing/changes — Races and prices that changed since a timestamp
• GET /v1/racing/events — Upcoming race list
• GET /v1/racing/greyhounds/form — Greyhound form history for one dog
• GET /v1/racing/greyhounds/stats — Greyhound record by track, distance, box or grade
• POST /v1/racing/horses/backfill — Queue a batch of horses for paced form collection
• DELETE /v1/racing/horses/backfill/{job_id} — Cancel the horses a job has not collected yet