Migration guide for deprecated fields

Learn how to migrate your apps to handle deprecated fields

๐Ÿ“…

Release date

Changes will be live on October 10th 2022. All deprecated endpoints and fields will be removed from the REST API.

๐Ÿ“˜

Response headers

Deprecated endpoints return the following response headers: Deprecated: true and Sunset: 10 October 2022 00:00:00 UTC.

A note on video gameโ€“specific endpoints

Video gameโ€“specific endpoints will be deprecated in the same fashion as the generic one. These endpoints are not listed here to keep the list clean.

In practice, this means that any change to a /resource endpoint will also affect all /{videogame}/resource endpoints, eg. /csgo/resource, /dota2/resource, etc.

Deprecated endpoints

The following endpoints are currently deprecated and will be entirely removed from the API on 10 October 2022:

Deprecated endpoints
/series/{series_id_or_slug}/players
/tournaments/{tournament_id_or_slug}/players

โš 

๏ธ Video gameโ€“specific endpoints

Keep in mind that video gameโ€“specific endpoints will also be removed.

Migration guide

To retrieve the list of players from a tournament, we recommend using the Get a tournament rosters endpoint.

Using the list of team rosters, you can aggregate the complete list of players by concatenating all players array.

For more information on tournaments participants, see tournaments in-depth.

๐Ÿ“˜

Why this change?

Tournament rosters is central to our API design. Endpoints like /tournaments/:id/players and /series/:id/players encourage alternative usages that can lead to knowledge gaps in the community.

Deprecated fields

โš 

๏ธ Video gameโ€“specific endpoints

Keep in mind that fields in video gameโ€“specific endpoints will also be removed.

Leagues

The following League fields are currently deprecated and will be entirely removed from the API on October 10th 2022:

Series

The following Series fields are currently deprecated and will be entirely removed from the API on October 10th 2022:

  • description โ€” this has always been null ๐Ÿ˜ฌ
  • tier โ€” moved to tournament level, see changelog

Affected series endpoints

Affected endpoints
/series
/series/{series_id_or_slug}
/series/running
/series/past
/series/upcoming
/teams/{team_id_or_slug}/series
/leagues/{league_id_or_slug}/series
/videogames/{videogame_id_or_slug}/series

Other affected endpoints

Series are also contained in other endpoints responses. In these endpoints too, the description and tiers fields will be removed from the Series objects.

Affected endpointField
/leaguesseries (array)
/leagues/{league_id_or_slug}series (array)
/teams/{team_id_or_slug}/leaguesseries (array)
/videogames/{videogame_id_or_slug}/leaguesseries (array)
/tournamentsseries
/tournaments/pastseries
/tournaments/runningseries
/tournaments/upcomingseries
/tournaments/{tournament_id_or_slug}series
/series/{series_id_or_slug}/tournamentsseries
/teams/{team_id_or_slug}/tournamentsseries
/leagues/{league_id_or_slug}/tournamentsseries
/videogames/{videogame_id_or_slug}/tournamentsseries

Tournaments

The following Tournaments fields are currently deprecated and will be entirely removed from the API on October 10th 2022:

Matches

The following Matches fields are currently deprecated and will be entirely removed from the API on October 10th 2022:

Affected match endpoints

Affected endpoints
/matches
/matches/past
/matches/running
/matches/upcoming
/matches/{match_id_or_slug}
/leagues/{league_id_or_slug}/matches
/leagues/{league_id_or_slug}/matches/past
/leagues/{league_id_or_slug}/matches/running
/leagues/{league_id_or_slug}/matches/upcoming
/series/{series_id_or_slug}/matches
/series/{series_id_or_slug}/matches/past
/series/{series_id_or_slug}/matches/running
/series/{series_id_or_slug}/matches/upcoming
/tournaments/{tournament_id_or_slug}/matches
/teams/{team_id_or_slug}/matches
/players/{player_id_or_slug}/matches

Other affected endpoints

Matches are also contained in other endpoints responses. In these endpoints too, the aforementioned fields will be removed from Matches objects.

Affected endpointField
/livesmatches (array)
/tournamentsmatches (array)
/tournaments/pastmatches (array)
/tournaments/runningmatches (array)
/tournaments/upcomingmatches (array)
/tournaments/{tournament_id_or_slug}matches (array)
/tournaments/{tournament_id_or_slug}/bracketsmatches (array)
/series/{series_id_or_slug}/tournamentsmatches (array)
/teams/{team_id_or_slug}/tournamentsmatches (array)
/leagues/{league_id_or_slug}/tournamentsmatches (array)
/videogames/{videogame_id_or_slug}/tournamentsmatches (array)

Games

The following Games fields is currently deprecated and will be entirely removed from the API on October 10th 2022:

  • video_url โ€” use streams_list at the match-level

Affected game endpoints

Affected endpoints
/csgo/games/{csgo_game_id}
/csgo/matches/{match_id_or_slug}/games
/dota2/games/{dota2_game_id}
/dota2/matches/{match_id_or_slug}/games
/lol/games/{lol_game_id}
/lol/matches/{match_id_or_slug}/games
/valorant/games/{valorant_game_id}
/valorant/matches/{match_id_or_slug}/games

Other affected endpoints

Games are also contained in other endpoints responses. In these endpoints too, the aforementioned fields will be removed from Games objects.

Affected endpointsField
/matchesgames (array)
/matches/pastgames (array)
/matches/runninggames (array)
/matches/upcominggames (array)
/matches/{match_id_or_slug}games (array)
/leagues/{league_id_or_slug}/matchesgames (array)
/leagues/{league_id_or_slug}/matches/pastgames (array)
/leagues/{league_id_or_slug}/matches/runninggames (array)
/leagues/{league_id_or_slug}/matches/upcominggames (array)
/series/{series_id_or_slug}/matchesgames (array)
/series/{series_id_or_slug}/matches/pastgames (array)
/series/{series_id_or_slug}/matches/runninggames (array)
/series/{series_id_or_slug}/matches/upcominggames (array)
/tournaments/{tournament_id_or_slug}/matchesgames (array)
/teams/{team_id_or_slug}/matchesgames (array)
/players/{player_id_or_slug}/matchesgames (array)
/tournaments/{tournament_id_or_slug}/bracketsgames (array)

Lives

The following Lives fields is currently deprecated and will be entirely removed from the API on October 10th 2022:

  • event

Affected live endpoints

Affected endpoints
/lives

Teams

The following Teams fields are currently deprecated and will be entirely removed from the API on October 10th 2022:

Players

The following Players fields are currently deprecated and will be entirely removed from the API on October 10th 2022:

  • birth_year โ€” use birthday instead, and read About players' age
  • hometown โ€” use nationality instead

Affected players endpoints

Affected endpoints
/players
/players/{player_id_or_slug}
/series/{series_id_or_slug}/players
/tournaments/{tournament_id_or_slug}/players

Other affected endpoints

Players are also contained in other endpoints responses. In these endpoints too, the aforementioned fields will be removed from Players objects.

Affected endpointsField
/teamsplayers array
/teams/{team_id_or_slug}players array
/tournaments/{tournament_id_or_slug}players array
/tournaments/{tournament_id_or_slug}/teamsplayers array

Stats

There are two types of stats endpoints: team stats and players stats. These endpoints will also be affected by the removal of previously mentioned fields.

Depending on the endpoint type (player or team) and the aggregated period for statistics (eg. over a match, tournament, series, or specified time range), the removed fields will be different.

Affected endpointsAffected by
/{videogame}/players/{player_id_or_slug}/statsPlayers
/{videogame}/matches/{match_id_or_slug}/players/statsPlayers, Matches
/{videogame}/tournament/{tournament_id_or_slug}/players/{player_id_or_slug}/statsPlayers, Tournaments
/{videogame}/series/{series_id_or_slug}/players/{player_id_or_slug}/statsPlayers, Series
/{videogame}/teams/{team_id_or_slug}/statsTeams
/{videogame}/tournament/{tournament_id_or_slug}/teams/{team_id_or_slug}/statsTeams, Tournaments
/{videogame}/series/{series_id_or_slug}/teams/{team_id_or_slug}/statsTeams, Series

Did this page help you?