Common Data Format - Event Data Schema

Unique match identifier

Indicates if synced tracking data is available (true) or not (false) for this event

Unique identifier of the event

Absolute time in UTC of when the event started (e.g., moment the pass is given, the moment the ball leaves the hands on a thrown in)

Period of the match which can be firsthalf, secondhalf, firsthalfextratime, secondhalfextratime, or shootout

Name of the event type (e.g. shot, pass, referee, defending, goalkeeping, misc etc.)

Name of the event sub type, which can be for shot - (penaltykick, freekick, cornerkick etc.); pass - (throwin, freekick, cornerkick, goalkick, kickoff etc.); referee - (finalwhistle, foul, caution, offside, substitution, playeron, playeroff. Player on and player off events occur for example when a player has to abandon the game due to a lack of available substitutions, or as a temporary measure after a medical check); defending - (clearance, interception, pressing, block etc.); goalkeeping - (save, saveattempt, claim, etc.); misc - (otherballaction, chancewithoutshot, tackle, etc.)

Denotes whether the event was successful (true) or not (false)

Event outcome options: shot - (successful, saved, blocked, wide, woodwork, owngoal); pass - (e.g. successful, outofplay, intercepted); referee - (start, end, injury, offside, yellowcard, redcard or secondyellowcard); defending - (e.g. clearance, block, interception, pressure); goalkeeping (e.g. save, saveattempt, claim); misc - (e.g. successful, unsuccessful)

Unique identifier of the player performing the action. For example, player committing a pass, or making a tackle. Required for all non-referee events. Referee events require event/official_id.

Unique team identifier of the player performing the action. Required for all non-referee events. Referee events require event/official_id.

Unique identifier of the official performing the action. Mandatory only when type is referee, else use event/playerid and event/teamid

Unique identifier of the player receiving a pass. Leave null when the event is not a pass or when the pass has no receiver.

Absolute time in UTC of the first moment the ball was received. Leave null when the event is not a pass or when the pass has no receiver.

Unique team identifier of the player identified by receiver_id, leave null if the event does not end with a known player in possession

x location where the action of player_id happened (m).

y location where the action of player_id happened (m).

x location where the action of player_id ended (m), null for single-point events that have no end coordinate.

y location where the action of player_id ended (m), null for single-point events that have no end coordinate.

Denotes the body part used by player_id, null allowed for events other than pass and shot.

Unique identifier(s) of the events related to the action, or pass and associated receival event. For example, a related aerial duel event or the playeroff event associated with a playeron event. Leave null if no related events exist.

The match clock as a string in format "MM:SS.mm" (i.e. minutes, seconds, milliseconds) (e.g. "92:01.04"). The clock resets to "45:00.00", "90:00.00" or "105:00.00" at the start of "secondhalf", "firsthalfextratime", "secondhalf_extratime", respectively.

Frame identifier from the tracking data related to the event at (x, y)

Frame identifier from the tracking data related to the event at (xend, yend)