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

# GET /football/matches/{match_id}/lineups

> Return confirmed match lineups, formations, starting XIs, and substitutes.

Return team sheets for a match.

## Endpoint

```text theme={null}
GET https://api.thestatsapi.com/api/football/matches/{match_id}/lineups
```

For finished and in-progress matches, this endpoint returns the actual starting XI plus substitutes, including substitutes who came on and unused bench players. For upcoming matches, it returns the confirmed starting XI once the official team sheet has been announced, usually about one hour before kickoff.

## Path parameters

| Name       | Type   | Required | Description                       |
| ---------- | ------ | -------- | --------------------------------- |
| `match_id` | string | Yes      | Match ID. Example: `mt_838955483` |

## Response

```json theme={null}
{
  "data": {
    "match_id": "mt_838955483",
    "confirmed": true,
    "home": {
      "id": "tm_0406",
      "name": "Liverpool",
      "formation": "4-3-3",
      "starting_xi": [
        {
          "id": "pl_29627593",
          "name": "Mohamed Salah",
          "position": "F",
          "jersey_number": 11
        }
      ],
      "substitutes": [
        {
          "id": "pl_7922290",
          "name": "Darwin Nunez",
          "position": "F",
          "jersey_number": 9
        }
      ]
    },
    "away": {
      "id": "tm_1002",
      "name": "Newcastle United",
      "formation": "4-3-3",
      "starting_xi": [
        {
          "id": "pl_4016958",
          "name": "Alexander Isak",
          "position": "F",
          "jersey_number": 14
        }
      ],
      "substitutes": []
    }
  }
}
```

<Note>
  If a lineup has not been announced yet, the endpoint returns `404`.
</Note>