Migrating to v2.33

Learn how to migrate your apps to PandaScore v2.33.

In version 2.33, all deprecated endpoints and fields will be removed from the REST API.

📅

Release date

v2.33 will be live on June 13th 2022

📘

Response headers

Deprecated endpoints return the following response headers: Deprecated: true and Sunset: Mon, 06 Jun 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 in v2.33:

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 in v2.33:

Series

The following Series fields are currently deprecated and will be entirely removed from the API in v2.33:

  • 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 in v2.33:

Matches

The following Matches fields are currently deprecated and will be entirely removed from the API in v2.33:

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 in v2.33:

  • 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 in v2.33:

  • event

Affected live endpoints

Affected endpoints
/lives

Teams

The following Teams fields are currently deprecated and will be entirely removed from the API in v2.33:

Players

The following Players fields are currently deprecated and will be entirely removed from the API in v2.33:

  • 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?