Frequently asked questions

📘

If you have more questions

This is a growing section answering commonly asked REST API questions. If you have any questions that you can't find an answer to on this page, please join our developer slack to get support!

What is the difference between the status field and the complete field at the game level?

The status field shows the current state that the game is in e.g. running, finished. The complete field is used to indicate whether a finished game has all possible statistics available for your access. It is recommended to use the status field as an indication of the game state, and the complete field as an indication of the data wholeness. Once a finished game is marked as complete = true, the statistics should not change. Additional statistics are available to those on a historical or live plan.

How can I tell whether a match will have post-game statistics?

The detailed_stats field should be used to determine whether a match will have post-game statistics. When detailed_stats = true, the match will have additional post-game statistics (which are available for those with a historical or live plan). If you're only interested in matches that will have detailed statistics available, you can make use of filtering to only receive these matches in the API response, e.g. https://api.pandascore.co/matches/upcoming?filter[detailed_stats]=true.
More details of filtering can be found in our documentation, and filtering options can be seen on each reference page.

When will post-game statistics be available?

Results will be available in real-time, and detailed post-game statistics will be available typically within 15 minutes of the game ending.

Where can I find the rosters for a tournament?

You can access tournament rosters via the endpoint /tournaments/{tournament_id_or_slug}/rosters. This endpoint displays the expected rosters for each team participating in the tournament. Further information for this endpoint can be found in our reference documentation.

What is a game advantage?

When a match has a game advantage, the first game of the match is automatically won by the specified opponent. This is due to the tournament format, and it is especially seen in tournaments with a lower bracket. The field game_advantage will contain the id of the corresponding opponent if there is a game advantage in the match, otherwise, the field will remain null.