Pass

The Game Data API is in preview. Endpoints, fields and limits may change before release, and it is not yet available to call.

Technical Details

Variable Type: Event
Event Type: pass
Subtypes: ground, lofted
Layer: ball (ball and player positions)
Returned By: List Game Events
Filter: event_type=pass

Description

A pass from one player to another, with its outcome. The subtype is the pass height: ground or lofted. Progressive passes and crosses are flagged with the progressive and cross booleans; a cross has two extra fields for where it came from and where it was aimed. The bypassed counts measure packing: how many opponents the pass takes out of the game. They are credited to both players: the _receiving fields count for the receiver. Every event has the same envelope fields, including time, frames, player, team, pitch coordinates, phase, team_possession_id, player_possession_id and confidence. See List Game Events. The fields below are specific to this type and are returned in attributes.

Attributes

Field	Units	Description
`receiver_player_id`	—	Player the pass was played to.
`outcome`	—	Result of the pass, for example `complete`.
`progressive`	—	Whether the pass moved the ball well toward the opponent’s goal.
`cross`	—	Whether the pass is a cross.
`length_m`	m	Length of the pass.
`pass_range`	—	`short` (under 15 m), `medium` (15–30 m) or `long` (over 30 m).
`progression_m`	m	Distance the pass moved the ball toward the opponent’s goal.
`into_box`	—	Whether the pass ended in the penalty box.
`ball_speed_kmh`	km/h	Speed of the ball.
`bypassed_opponents`	count	Opponents the pass takes out of the game.
`bypassed_defenders`	count	Players in the opponent’s last line that the pass takes out of the game.
`bypassed_opponents_receiving`	count	Opponents taken out of the game, credited to the receiver.
`bypassed_defenders_receiving`	count	Last-line defenders taken out of the game, credited to the receiver.
`from_zone`	—	Crosses only. Area the cross was played from, for example `right_wide`.
`target_zone`	—	Crosses only. Area the cross was aimed at, for example `far_post`.

Example

Only the type-specific fields and a few envelope fields are shown.

{
  "event_type": "pass",
  "event_subtype": "ground",
  "player_id": "p07",
  "team_id": "t-0451",
  "team_side": "home",
  "player_possession_id": "pos-0213",
  "phase": "build_up",
  "attributes": {
    "receiver_player_id": "p10",
    "outcome": "complete",
    "progressive": true,
    "cross": false,
    "length_m": 25.4,
    "pass_range": "medium",
    "progression_m": 21.9,
    "into_box": false,
    "ball_speed_kmh": 48.2,
    "bypassed_opponents": 3,
    "bypassed_defenders": 1
  }
}

{
  "event_type": "pass",
  "event_subtype": "lofted",
  "attributes": {
    "receiver_player_id": "p09",
    "outcome": "complete",
    "progressive": false,
    "cross": true,
    "from_zone": "right_wide",
    "target_zone": "far_post"
  }
}

API Documentation

Data Export

Captures

Athletes

Game Data (Preview)

Technical Details

Description

Attributes

Example

Technical Details

Description

Attributes

Example

Related