Event descriptions
A description of each Field available in the LIVE Data API in alphabetical order.
| Name | Description |
|---|---|
| bad-behaviour | A player receives a card due to an infringement outside of play |
| ball-receipt | The receipt or intended receipt of a pass |
| ball-recovery | An attempt to recover a loose ball |
| block | Blocking the ball by standing in its path |
| clearance | Action by a defending player to clear the danger without an intention to deliver it to a teammate |
| dispossessed | Player loses ball to an opponent as a result of being tackled by a defender without attempting a dribble |
| dribble | An attempt by a player to beat an opponent |
| dribble-past | Player is dribbled past by an opponent |
| duel | 50-50 contest between two players of opposing sides in the match |
| end-stoppage | The end of a stoppage event |
| fifty-fifty | 2 players challenging to recover a loose ball |
| foul-committed | Any infringement that is penalised as foul play by a referee |
| foul-won | A player wins a free-kick or penalty for their team after being fouled by an opposing player |
| goal-keeper | Actions that can be done by the goalkeeper |
| half-end | Signals the referee whistle to finish a match period |
| half-start | Signals referee whistle to start a match period |
| interception | Preventing an opponent's pass from reaching their teammates by moving to the passing lane/reacting to intercept it |
| miscontrol | Player loses ball due to bad touch |
| match_id | Unique StatsBomb identity for a match |
| out | Ball goes out of play |
| own-goal-against | An own goal scored against the team |
| own-goal-for | An own goal scored for the team |
| pass | Ball is passed between teammates |
| period | The period of time in which an event occured, i.e. first half, second half, extra time |
| player-off | A player goes/ is carried out of the pitch without a substitution |
| player-on | A player returns to the pitch after a player-off event |
| referee-ball-drop | Referee drops the ball to continue the game after an injury stoppage |
| shot | An attempt to score a goal, made with any (legal) part of the body |
| starting-xi | Players in the starting 11, their position and the team’s formation |
| stoppage | A stop in play due to an injury or review |
| substitution | The team replaces a player on to the pitch in exchange for an existing player |
| tactical-shift | Indicates a tactical shift made by the team, shows the players' new positions and the team's new formation |