/
v3.0.11Get access

subscribeToGamesWithSport

This API is a comprehensive real-time subscription service used to track sports matches. It is highly flexible, allowing you to filter by specific IDs or broad categories (like aliases) while receiving a structured, nested data update via a listener. Structure will include sport -> region -> competition -> game data.

Request parameters:

NameDescriptionTypeValuesDefault
gameIds
A list of unique identifiers for the matches you want to followarray--
favorite
Only returns games marked as favorites.booleantrue / false-
gameTypes
Game typesarray["sport", "live", "willBeLiveSoon"]-
sportAlias
Filter by sport alias (e.g., "Soccer").string--
excludeGames
Flag with which gameIds will be ignored.booleantrue / false-
regionAliases
Filter by region aliasesarray--
competitionIds
Filter by league IDs.array--
isCloudAvailable
Filters games that support cloud-basedbooleantrue / false-
isOlympicAvailable
A specific toggle likely used to filter for Olympic Games eventsbooleantrue / false-
isBetBuilderAvailable
Filters matches where the "Bet Builder" feature is active.booleantrue / false-
isSportOuterJoin
Allows to get sport data even when no games match the filtersbooleantrue / false-
isInternalBetBuilderAvailable
Feature toggles that instruct the stream to include or exclude complex same-game-parlay (Internal Bet Builder) pricing configurations and data structures.booleantrue / false-

Call example:

subscribeToGamesWithSport({
  gameIds: [29487908],
  regionAliases: ['Spain']
})

Response examples:

{
  sport: {
    '1': {
      id: 1,
      name: 'Football',
      alias: 'Soccer',
      region: {
        '2150001': {
          id: 2150001,
          name: 'Spain',
          alias: 'Spain',
          competition: {
            '545': {
              id: 545,
              name: 'La Liga',
              order: 4003,
              game: {
                '29487908': {
                  id: 29487908,
                  info: {
                    current_game_state: 'notstarted',
                    current_game_time: '0',
                    add_minutes: '0',
                    stoppage_firsthalf: '02:00',
                    stoppage_secondhalf: '05:00',
                    score1: '0',
                    score2: '0',
                    pass_team: 'none',
                    shirt1_color: '000000',
                    shirt2_color: '000000',
                    short1_color: '000000',
                    short2_color: '000000',
                    field: 0
                  },
                  stats: {
                    passes: {
                      team1_value: null,
                      team2_value: null
                    }
                  },
                  promoted: false,
                  is_live: false,
                  team2_id: 508,
                  start_ts: 1777316400,
                  team1_id: 496,
                  team1_name: 'Espanyol',
                  team2_name: 'Levante',
                  is_blocked: 0,
                  sport_alias: 'Soccer',
                  match_length: '90',
                  team1_reg_name: 'ES',
                  team2_reg_name: 'ES'
                }
              }
            }
          }
        }
      }
    }
  }
}