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

# Formation

> A team's formation in a period.

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

## Description

A team's formation in a period, overall and in possession.

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 |
| - | - | - |
| `formation` | — | Formation, for example `4-3-3`. |
| `in_possession_formation` | — | Formation in possession, for example `3-2-5`. |

## Example

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

```json theme={null}
{
  "event_type": "formation",
  "team_id": "t-0451",
  "team_side": "home",
  "period": 1,
  "confidence": 0.77,
  "attributes": {
    "formation": "4-3-3",
    "in_possession_formation": "3-2-5"
  }
}
```

## Related

* [Team Shape](https://docs.uplift.ai/api-reference/game-data/event-catalogue/events/team-shape)


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