Skip to content

Event Types

Event types detected by the analysis engine and returned by the Events endpoint.

The Schema endpoint lists the event types and properties a given analysis carries. Ball actions are queried with the event_property filter.

Ball Actions

Event Type Description
Pass A deliberate attempt to deliver the ball to a teammate. The unified pass event covers open-play...
Carry A player moving with the ball at their feet while keeping control of it. The span covers...
Drive A carry of at least 3 m: the player moved the ball somewhere under control. Derived from the...
Shot An attempt to score: a kick or other body contact directed at the opponent's goal, with any body...

Possession

Event Type Description
Team Possession A continuous span over which one team is in possession of the ball. Ends when possession...
Player Possession A continuous span over which one specific player is the active ball-carrier. Distinct from...

Structure

Event Type Description
Ball Phase A continuous span describing whether the ball is in play, out of bounds, or in a stoppage....
Ball Pitchzone A continuous span describing which longitudinal third of the pitch the ball is currently in....
Scene A continuous span of the broadcast feed of a single scene type. is_analysable is true for the...
Match Timeline A set of spans that place the match on the frame timeline, so every other event can be read...

Match Events

Event Type Description
Goal A goal: the ball has fully crossed the goal line between the posts and under the crossbar, and...