/
v3.0.11Get access

subscribeToRacingGamesWithRegion

This API function establishes a highly filtered, real-time subscription for racing events, narrowing the data stream down by both a geographic region and a specific timeline/day. It ensures the client application receives live schedule or odds updates perfectly aligned with both where the races are taking place and the user's localized calendar day.

Request parameters:

NameDescriptionTypeValuesDefault
timeZone
The user's local time zone. This is critical for calculating when a timePeriod (like "today") technically starts and ends for that specific viewer.number--
sportAlias
Specifies the racing category to monitor.string--
regionAlias
Filters the events by their physical country or racing territory.string--
timePeriod
Scopes the query to a specific temporal window.string"all", "future", "today", "tomorrow"-

Parameters marked with must be included in the request

Call example:

subscribeToRacingGamesWithRegion({
  regionAlias: 'United Kingdom',
  sportAlias: 'HorseRacing',
  timePeriod: 'today',
  timeZone: 4
})

Response examples:

{
  region: {
    '2410031': {
      id: 2410031,
      alias: 'United Kingdom',
      name: 'United Kingdom',
      order: 1,
      competition: {
        '4901': {
          id: 4901,
          name: 'Worcester',
          order: 3068,
          bog: false,
          game: {
            '29880048': {
              id: 29880048,
              start_ts: 1779978600
            },
            '29880049': {
              id: 29880049,
              start_ts: 1779980400
            }
          }
        },
        '4902': {
          id: 4902,
          name: 'Yarmouth',
          order: 3013,
          bog: false,
          game: {
            '29880020': {
              id: 29880020,
              start_ts: 1779978180
            },
            '29880021': {
              id: 29880021,
              start_ts: 1779979980
            }
          }
        }
      }
    }
  }
}