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

# Off-Ball Run

> A run made while a teammate has 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:** `off_ball_run`
* **Subtypes:** `behind`, `run_ahead_of_the_ball`, `overlap`, `underlap`
* **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=off_ball_run`

## Description

A run made while a teammate has the ball. Each run is tied to the teammate's possession through `player_possession_id`.

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 |
| - | - | - |
| `peak_speed_kmh` | km/h | Top speed during the run. |
| `distance_m` | m | Distance covered during the run. |
| `targeted` | — | Whether a pass was aimed at the runner. |
| `received` | — | Whether the runner received the ball. |
| `dangerous` | — | Whether the run was classed as dangerous. |
| `broke_last_line` | — | Whether the run went beyond the opponent's last line. |

## Example

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

```json theme={null}
{
  "event_type": "off_ball_run",
  "event_subtype": "behind",
  "player_possession_id": "pos-0213",
  "attributes": {
    "peak_speed_kmh": 31.2,
    "distance_m": 18.4,
    "targeted": true,
    "received": false,
    "dangerous": true,
    "broke_last_line": true
  }
}
```

## Related

* [Passing Option](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/passing-option)
* [High-Speed Running](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/high-speed-running)


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