PandaScore implements match statuses as a finite state machine. The diagram below is a recap of all existing match statuses (the states) and the events that can affect them (the transitions).
Matches always start with the Not Started status. In this state:
scheduled_atis the official playing time — as announced by the organizer
begin_athas the same value as
scheduled_at(to support some legacy integrations)
For matches that support real-time in-game data, the WebSocket opens 15 minutes prior to the scheduled time.
Retrieve the list of open WebSockets with the All video games > List live matches endpoint.
When an organizer decides to reschedule match, the
rescheduled field will be set to
true. In this state:
scheduled_atis the new official playing time — as announced by the organizer
original_scheduled_atis the initial official playing time
Matches will only be marked as rescheduled when the organizer officially announces a new date. Matches that are delayed (eg. because the previous match is not finished) will not be marked as rescheduled.
Matches status is updated to Running as soon as the match starts. In this state:
begin_atis set to the actual begin time of the match
Matches status is updated to Finished as soon as the match ends. In this state:
end_atis set to the match finish time
For matches that support historical data (ie.
true), the post-game statistics will be available.
Sometimes, matches can be canceled. Reasons may vary and different scenarios exist: cancellation by the organizer or one participant forfeiting.
In this scenario, the match status is updated to
Canceled. In this state:
A match goes in Canceled status when for various potential reasons it won't be played.
In this scenario too, the match status is updated to
Canceled. However, in this state:
Matches status is updated to Postponed when the match is postponed to an unknown date. In this state, the match
postponed but the
scheduled_at is not updated.
As a new playing date is known, postponed matches go through the same procedure as rescheduled matches.
Updated 5 months ago