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

# Carry

> A player moving with the ball.

> [!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:** `carry`
* **Subtypes:** `dribble`
* **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=carry`

## Description

A player moving with the ball. When the player beats an opponent, the subtype is `dribble`.

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 |
| - | - | - |
| `distance_m` | m | Distance the player carried the ball. |
| `progression_m` | m | Distance the carry moved the ball toward the opponent's goal. |
| `opponent_beaten_id` | — | Opponent beaten, for a `dribble`. |
| `outcome` | — | Result of the carry, for example `retained`. |
| `bypassed_opponents` | count | Opponents the carry takes out of the game. |

## Example

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

```json theme={null}
{
  "event_type": "carry",
  "event_subtype": "dribble",
  "attributes": {
    "distance_m": 11.3,
    "progression_m": 8.7,
    "opponent_beaten_id": "a03",
    "outcome": "retained",
    "bypassed_opponents": 1
  }
}
```

## Related

* [Line Break](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/line-break)
* [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.