Venues

Returns a list of all known venues/tracks, optionally filtered by race type and country. Useful for building track selectors or validating track slugs.

Parameters

raceTypestring

optional

Filter by race type: gallops, harness, or greyhounds. Returns all types if omitted.

countrystring

optional

Two-letter country code (e.g. au, nz, hk, gb, us). Returns all countries if omitted.

Code Examples

javascript

const response = await fetch(
  'https://api.formfav.com/v1/form/venues?' +
  new URLSearchParams({
    raceType: 'gallops',
    country: 'au'
  }),
  {
    headers: { 'X-API-Key': 'your_api_key_here' }
  }
);

const data = await response.json();

Response Fields

countinteger

Total number of matching venues

venuesarray

List of venues

venues[].namestring

Venue display name

venues[].slugstring

URL-safe slug for use in API calls

venues[].raceTypestring

Race type at this venue

venues[].countrystring

Two-letter country code

Example Response

200

Response

json

{
  "count": 3,
  "venues": [
    { "name": "Flemington", "slug": "flemington", "raceType": "gallops", "country": "au" },
    { "name": "Randwick", "slug": "randwick", "raceType": "gallops", "country": "au" },
    { "name": "Eagle Farm", "slug": "eagle-farm", "raceType": "gallops", "country": "au" }
  ]
}