Endpoints
All events
Retrieve a list of events for your organization. Filter by type, series, or date range to narrow results.
/eventsQuery Parameters
limitnumberrequireddefault: 50Items per page (1-100, default 50).
afterstringOpaque cursor from a previous response's `cursor` field; returns the next page.
typeenum<string>Filter by event type
Available options: race,runClub,timeTrial,other
dateFromstringFilter events on or after this date (YYYY-MM-DD). Event dates are days on each venue's clock and compare as days.
dateTostringFilter events on or before this date (YYYY-MM-DD). Event dates are days on each venue's clock and compare as days.
Authorization
read:eventsResponse
idstringrequiredEvent ID
namestringrequiredEvent name
slugstringrequiredURL slug
typeenum<string>requiredEvent type
Available options: race,runClub,timeTrial,other
datestringrequiredEvent date (YYYY-MM-DD) on the venue's clock — see `timezone`.
organizationIdstringrequiredOwning organization ID
startTimestringStart time (HH:MM) on the venue's clock — see `timezone`.
timezonestringThe venue's IANA timezone (e.g. America/Los_Angeles): the clock every date and time on this event is read on. Absent while the venue's location is not known; then dates and times are the venue's own, with no offset.
startsAtstringThe start as an ISO-8601 instant with the venue's offset (e.g. 2026-04-18T07:00:00-07:00). Present when `startTime` and `timezone` are both known.
addressobjectEvent location
latnumberlngnumberdescriptionstringEvent description
websiteUrlstringEvent website URL
cardImageUrlstringCard image URL (grid/list thumbnails).
coverImageUrlstringCover/hero image URL (event pages).
registrationUrlstringRegistration page URL
temporalStatusenum<string>requiredDerived from the event's dates on the venue's clock at the time of the request: past | in_progress | future. While `timezone` is not known the dates are read Anywhere on Earth (UTC−12), so a day lasts until it has ended everywhere.
Available options: past,in_progress,future