GET /football/matches/{match_id}/lineups - The Stats API

Return team sheets for a match.

Endpoint

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

{
  "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": []
    }
  }
}

If a lineup has not been announced yet, the endpoint returns 404.