> ## 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.

# Passing Option

> A teammate available to receive a pass.

> [!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:** `passing_option`
* **Subtypes:** None
* **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=passing_option`

## Description

A teammate available to receive a pass during a player possession, whether or not the ball is played to them.

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 |
| - | - | - |
| `duration_s` | s | How long the player was available. |
| `targeted` | — | Whether a pass was aimed at the player. |
| `received` | — | Whether the player received the ball. |
| `dangerous` | — | Whether the option was classed as dangerous. |
| `xthreat` | — | Expected threat of a pass to this player. |
| `xpass_completion` | 0–1 | Likelihood that a pass to this player would be completed. |
| `opponents_bypassed_if_received` | count | Opponents a pass to this player would take out of the game. |

## Example

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

```json theme={null}
{
  "event_type": "passing_option",
  "player_id": "p10",
  "player_possession_id": "pos-0213",
  "attributes": {
    "duration_s": 1.6,
    "targeted": true,
    "received": true,
    "dangerous": false,
    "opponents_bypassed_if_received": 3
  }
}
```

## Related

* [Off-Ball Run](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/off-ball-run)
* [Pass](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/pass)
* [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.