> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uplift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pass

> A pass from one player to another, with its outcome.

> [!WARNING]
>
> 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](https://docs.uplift.ai/api-reference/game-data/events/list.md)
* **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](https://docs.uplift.ai/api-reference/game-data/events/list.md). 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.

```json theme={null}
{
  "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
  }
}
```

```json theme={null}
{
  "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"
  }
}
```

## Related

* [Line Break](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/line-break)
* [Carry](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/carry)
* [Passing Option](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/passing-option)
* [Player Possession](https://docs.uplift.ai/api-reference/game-data/event-catalogue/segments/player-possession)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.