> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lineups Channel - Team & Player Lineup Updates

> Stream realtime team lineup updates via WebSocket. Starting lineups, bench players, and formation data for pre-match and in-game sports analytics.

> [!NOTE]
>
> **Beta** — the lineups field set is being finalized. The shape below is indicative; payloads may still vary by provider until the canonical model ships. Handle unknown fields gracefully.

## What it streams

Team/player lineup updates for fixtures: starting lineups, bench, and formations. A lineup update is a **snapshot** — treat each message as the full current lineup for that side, replacing the previous one.

## Routing

* Entity key: `fixtureId` (in `payload.fixtureId`)
* Filters: `sportIds`, `tournamentIds`, `fixtureIds`

## Indicative payload

| Field | Type | Description |
| - | - | - |
| `fixtureId` | `string` | The fixture the lineup belongs to |
| `side` | `integer` | `1` = participant1, `2` = participant2 |
| `formation` | `string \| null` | Formation as delivered (e.g. `4-3-3`), where applicable |
| `players` | `array` | Player entries: `playerId`, `playerName`, starter/bench role, position |
| `meta` | `object` | Additional provider detail |

Use `entryId` for ordering and resume where supported.


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