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

# Team Shape

> A team's shape and defensive line height, sampled over time.

> [!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:** `team_shape`
* **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=team_shape`

## Description

A team's shape and defensive line height, sampled over time for each team.

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 |
| - | - | - |
| `defensive_line_height_m` | m | Height of the defensive line up the pitch. |
| `team_length_m` | m | Distance from the deepest to the furthest-forward outfield player. |
| `team_width_m` | m | Distance between the widest outfield players. |
| `compactness_m2` | m² | Area the team covers. |
| `block` | — | Defensive block, for example `medium_block`. |

## Example

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

```json theme={null}
{
  "event_type": "team_shape",
  "team_id": "t-0388",
  "team_side": "away",
  "attributes": {
    "defensive_line_height_m": 31.5,
    "team_length_m": 38.2,
    "team_width_m": 44.0,
    "compactness_m2": 1290,
    "block": "medium_block"
  }
}
```

## Related

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