/
v3.0.11Get access

subscribeToLiveGamesWithRegion

This API provides a structured, real-time data subscription that groups live match details and statistics hierarchically by **Region** and **Competition**. It uses the `sportAlias` as a unique string identifier (e.g., `'soccer'`) to filter the entire data stream to a specific sport. Data structure region -> competition -> game

Request parameters:

NameDescriptionTypeValuesDefault
sportAlias
A unique identifier for a sport.string--

Call example:

subscribeToLiveGamesWithRegion({
  sportAlias: 'Soccer'
})

Response examples:

{
  region: {
    '140001': {
      name: 'Angola',
      alias: 'Angola',
      order: 99,
      id: 140001,
      competition: {
        '18293150': {
          id: 18293150,
          name: 'Liga Bantu',
          order: 9999,
          game: {
            '29755379': {
              id: 29755379,
              info: {
                current_game_state: 'Half Time',
                add_minutes: '0',
                stoppage_firsthalf: '03:00',
                stoppage_secondhalf: '05:00',
                score1: '2',
                score2: '2',
                pass_team: 'none',
                shirt1_color: '50E3C2',
                shirt2_color: 'F8E71C',
                short1_color: '50E3C2',
                short2_color: 'F8E71C',
                field: 0
              },
              stats: {
                corner: {
                  team1_value: 1,
                  team2_value: 1
                },
                shot_on_target: {
                  team1_value: 2,
                  team2_value: 3
                }
              },
              team1_id: 1054677,
              team2_id: 1054683,
              team2_name: 'Desportivo Kalandula',
              team1_name: 'Herois do Huambo',
              region_alias: 'Angola'
            }
          }
        }
      }
    },
    '210001': {
      name: 'Australia',
      alias: 'Australia',
      order: 90,
      id: 210001,
      competition: {
        '6126': {
          id: 6126,
          name: 'Australia Cup',
          order: 6,
          game: {
            '29747018': {
              id: 29747018,
              info: {
                current_game_state: 'set2',
                current_game_time: '90',
                add_minutes: '2',
                match_add_minutes: '5',
                stoppage_firsthalf: '02:00',
                stoppage_secondhalf: '05:00',
                score1: '1',
                score2: '0',
                pass_team: 'none',
                shirt1_color: 'F8E71C',
                shirt2_color: 'FFFFFF',
                short1_color: '000000',
                short2_color: '000000',
                field: 0
              },
              stats: {
                dangerous_attack: {
                  team1_value: 14,
                  team2_value: 22
                },
                attack: {
                  team1_value: 16,
                  team2_value: 26
                }
              },
              team1_id: 13462,
              team2_id: 7594,
              team2_name: 'Adelaide City FC',
              team1_name: 'Cumberland United FC',
              region_alias: 'Australia'
            }
          }
        }
      }
    }
  }
}