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

# Change of Direction

> A sharp cut at 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:** `change_of_direction`
* **Subtypes:** None
* **Layer:** `position` (player positions only)
* **Returned By:** [List Game Events](https://docs.uplift.ai/api-reference/game-data/events/list.md)
* **Filter:** `event_type=change_of_direction`

## Description

A sharp cut at speed.

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 |
| - | - | - |
| `heading_change_deg` | ° | How far the player's heading changed. |
| `entry_speed_kmh` | km/h | Speed going into the cut. |
| `exit_speed_kmh` | km/h | Speed coming out of the cut. |
| `peak_mps2` | m/s² | Peak acceleration during the cut. |
| `exit_direction_deg` | ° | Direction the player left the cut in. 0° is towards the opponent's goal. |

## Example

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

```json theme={null}
{
  "event_type": "change_of_direction",
  "attributes": {
    "heading_change_deg": 74,
    "entry_speed_kmh": 21.6,
    "exit_speed_kmh": 18.0,
    "peak_mps2": 6.2,
    "exit_direction_deg": 15
  }
}
```

## Related

* [Acceleration / Deceleration](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/acceleration-deceleration)


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