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

# Key Moment

> A passage selected for closer analysis, such as a fast break.

> [!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:** `key_moment`
* **Subtypes:** `fatigued_player`, `fast_break`, `player_down`, in `segment_subtype`
* **Returned By:** [List Game Segments](https://docs.uplift.ai/api-reference/game-data/segments/list.md)
* **Filter:** `segment_type=key_moment`

## Description

A passage selected for closer analysis. The kind of moment is in `segment_subtype`. There are a few per clip, and they can overlap. Key moments list their events but are never used to filter or count events.

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 |
| - | - | - |
| `score` | — | How significant the moment is. Higher is more significant. |
| `strength` | — | Strength band for the score, for example `strong`. |
| `anchor_event_id` | — | `event_id` of the event the moment is built around. |
| `event_ids` | — | `event_id` of each event in the moment. |
| `key_players` | — | Players picked for 3D skeleton analysis: `player_id`, whether it ran (`ik`), and the frames covered (`ik_frame_start`, `ik_frame_end`). |
| `attack_speed_mps` | m/s | `fast_break` only. Speed of the attacking team. |
| `defense_speed_mps` | m/s | `fast_break` only. Speed of the defending team. |

## Example

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

```json theme={null}
{
  "segment_type": "key_moment",
  "segment_subtype": "fast_break",
  "segment_id": "km-0012",
  "attributes": {
    "score": 6.4,
    "strength": "strong",
    "anchor_event_id": "shot-02310-p10",
    "event_ids": [
      "pass-01871-p07",
      "off_ball_run-01960-p09",
      "shot-02310-p10"
    ],
    "key_players": [
      {
        "player_id": "p10",
        "ik": true,
        "ik_frame_start": 2240,
        "ik_frame_end": 2335
      }
    ],
    "attack_speed_mps": 5.2
  }
}
```

## Related

* [Shot](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/shot)
* [Player Down](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/player-down)
* [Phase of Play](https://docs.uplift.ai/api-reference/game-data/event-catalogue/segments/phase-of-play)


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