Skip to content

Course

Object type

A racing venue. Reference data — relatively static; referenced by every meeting and (via the meeting) every race. Use tla for compact displays and joining against legacy feeds that key on the three-letter code.

FieldArgsTypeDescription
idID! requiredStable Podium identifier (UUID).
nameString! requiredFull course name (e.g. Cheltenham, Curragh).
displayNameStringShort display name where the full name is long. Falls back to name if null.
tlaStringThree-letter abbreviation (e.g. ASC Ascot, CHE Cheltenham). The standard short code used across racing systems. Null for football stadiums, which have no stable TLA (courses.tla is nullable since migration 134).
countryCodeString! requiredISO 3166-1 alpha-2 country code (GB, IE, FR, …).
timeZoneString! requiredIANA time-zone identifier (e.g. Europe/London). Use this to interpret a meeting’s local times.
directionCourseDirectionDirection horses run around the course.
locationGeoLocationGPS coordinates for the venue. Null where geocoding has not been performed.