Skip to main content
Every event returned by the API includes a status field indicating its current state. Use these values to determine how to display or process an event in your application.
Additional sport-specific statuses may appear in API responses (e.g., MMA fight statuses, cricket-specific statuses). The statuses above cover the most common values. Use the event_status_detail field on the score object for a human-readable description of the current state.
Which of these values you see depends on the sport. The table above is the full vocabulary, not the set any single sport uses. A soccer match in play reports STATUS_FIRST_HALF, where tennis reports STATUS_IN_PROGRESS for the same situation. Do not carry an assumption from one sport across to another.Treat an unrecognized status as unknown rather than an error, since values are added over time. If you are detecting period transitions, live_game_state.period and the clock fields are more portable than matching status strings.