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

# High-Speed Running

> An effort above high-speed running speed.

> [!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:** `high_speed_running`
* **Subtypes:** `high_speed`, `sprint`
* **Layer:** `position` (player positions only)
* **Returned By:** [List Game Events](https://docs.uplift.ai/api-reference/game-data/events/list.md)
* **Filter:** `event_type=high_speed_running`

## Description

An effort above high-speed running speed. Efforts that reach sprint speed have the subtype `sprint`; the rest are `high_speed`. The speed thresholds are returned by [Get Physical Summary](https://docs.uplift.ai/api-reference/game-data/physical/get.md).

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 effort. |
| `distance_m` | m | Distance covered. |
| `duration_s` | s | Length of the effort. |
| `sprint_share` | 0–1 | Share of the effort spent above sprint speed. |
| `attacking` | — | Whether the effort was made in attack. |
| `direction` | — | Direction of the effort, for example `towards_goal`. |
| `intensity_tier` | — | Intensity band, for example `high`. |

## Example

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

```json theme={null}
{
  "event_type": "high_speed_running",
  "event_subtype": "sprint",
  "attributes": {
    "peak_speed_kmh": 32.4,
    "distance_m": 27.8,
    "duration_s": 3.4,
    "sprint_share": 0.71,
    "direction": "towards_goal",
    "intensity_tier": "high"
  }
}
```

## Related

* [Acceleration / Deceleration](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/acceleration-deceleration)
* [Off-Ball Run](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/off-ball-run)
* [Get Physical Summary](https://docs.uplift.ai/api-reference/game-data/physical/get.md)


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