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

# Player Possession

> One player's spell on the ball, from first touch to release.

> [!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:** Segment
* **Segment Type:** `player_possession`
* **Returned By:** [List Game Segments](https://docs.uplift.ai/api-reference/game-data/segments/list.md)
* **Filter:** `segment_type=player_possession`

## Description

One player's spell on the ball, from first touch to release. Passes, off-ball runs and passing options point to it through `player_possession_id`.

Every segment has the same envelope fields: time, frames, team, player, `confidence` and `layer`. See [List Game Segments](https://docs.uplift.ai/api-reference/game-data/segments/list.md). The fields below are specific to this type and are returned in `attributes`.

## Attributes

| Field | Units | Description |
| - | - | - |
| `team_possession_id` | — | `segment_id` of the team possession it belongs to. |
| `phase` | — | Phase of play the possession happened in. |
| `touches` | count | Number of touches. |
| `carry_distance_m` | m | Distance the player carried the ball. |
| `pressure_at_reception` | 1–5 | Pressure on the player when they received the ball, from 1 (least) to 5 (most). |
| `start_type` | — | How the spell started, for example `corner_reception`. |
| `end_type` | — | How the spell ended, for example `pass`. |
| `end_event_id` | — | `event_id` of the event that ended the spell. |

## Example

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

```json theme={null}
{
  "segment_type": "player_possession",
  "segment_id": "pos-0213",
  "player_id": "p07",
  "attributes": {
    "team_possession_id": "tpos-0088",
    "phase": "create",
    "touches": 3,
    "carry_distance_m": 6.8,
    "pressure_at_reception": 3,
    "end_type": "pass",
    "end_event_id": "pass-01871-p07"
  }
}
```

## Related

* [Pass](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/pass)
* [Passing Option](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/passing-option)
* [On-Ball Engagement](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/on-ball-engagement)


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