get_lineups

5 creditsStats + aggregationPOST /v1/get_lineups

Formations, starting XIs, benches and substitutions with minutes

Use it when you want formations, starting XIs, who came on and when, and the unused bench.

Parameters

game_idstringrequired: ESPN match id, from list_games or get_schedule.

Notes

Over MCP, ask for it in plain English and the client calls get_lineups itself. Point any MCP client at https://mcp.strikerapi.com/mcp?key=YOUR_API_KEY.
Each call costs 5 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.strikerapi.com/v1/get_lineups \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "740916"
}'

Response

json

{
  "game": {
    "game_id": "740916",
    "season": 2025,
    "stage": "Regular Season",
    "date": "2026-04-19",
    "starts_at": "2026-04-19T15:30:00.000Z",
    "status": "final",
    "status_detail": "FT",
    "home": {
      "team_id": "382",
      "abbrev": "MNC",
      "name": "Manchester City",
      "score": 2
    },
    "away": {
      "team_id": "359",
      "abbrev": "ARS",
      "name": "Arsenal",
      "score": 1
    },
    "result": "H",
    "neutral_site": null,
    "venue": "Etihad Stadium",
    "city": "Manchester",
    "attendance": 52523
  },
  "lineups": [
    {
      "team_id": "382",
      "abbrev": "MNC",
      "formation": "4-2-3-1",
      "starting_xi": [
        {
          "player_id": "217092",
          "name": "Gianluigi Donnarumma",
          "jersey": "25",
          "position": "Goalkeeper",
          "formation_place": 1,
          "minute_on": 0,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        },
        {
          "player_id": "303785",
          "name": "Matheus Nunes",
          "jersey": "27",
          "position": "Right Back",
          "formation_place": 2,
          "minute_on": 0,
          "minute_off": null,
          "goals": 0,
          "assists": 1,
          "yellow_cards": 0,
          "red_cards": 0
        },
        {
          "player_id": "328464",
          "name": "Nico O'Reilly",
          "jersey": "33",
          "position": "Left Back",
          "formation_place": 3,
          "minute_on": 0,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        }
      ],
      "substitutes_used": [
        {
          "player_id": "250787",
          "name": "Phil Foden",
          "jersey": "47",
          "position": null,
          "formation_place": null,
          "minute_on": 85,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        },
        {
          "player_id": "323986",
          "name": "Nico González",
          "jersey": "14",
          "position": null,
          "formation_place": null,
          "minute_on": 88,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        },
        {
          "player_id": "304470",
          "name": "Sávio",
          "jersey": "26",
          "position": null,
          "formation_place": null,
          "minute_on": 88,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        }
      ],
      "unused_substitutes": [
        {
          "player_id": "307118",
          "name": "James Trafford",
          "jersey": "1"
        },
        {
          "player_id": "157974",
          "name": "John Stones",
          "jersey": "5"
        },
        {
          "player_id": "303745",
          "name": "Omar Marmoush",
          "jersey": "7"
        }
      ]
    },
    {
      "team_id": "359",
      "abbrev": "ARS",
      "formation": "4-3-3",
      "starting_xi": [
        {
          "player_id": "196176",
          "name": "David Raya",
          "jersey": "1",
          "position": "Goalkeeper",
          "formation_place": 1,
          "minute_on": 0,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        },
        {
          "player_id": "328497",
          "name": "Cristhian Mosquera",
          "jersey": "3",
          "position": "Right Back",
          "formation_place": 2,
          "minute_on": 0,
          "minute_off": 74,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 1,
          "red_cards": 0
        },
        {
          "player_id": "292062",
          "name": "Piero Hincapié",
          "jersey": "5",
          "position": "Left Back",
          "formation_place": 3,
          "minute_on": 0,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        }
      ],
      "substitutes_used": [
        {
          "player_id": "269844",
          "name": "Gabriel Martinelli",
          "jersey": "11",
          "position": null,
          "formation_place": null,
          "minute_on": 45,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        },
        {
          "player_id": "241077",
          "name": "Ben White",
          "jersey": "4",
          "position": null,
          "formation_place": null,
          "minute_on": 74,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        },
        {
          "player_id": "174980",
          "name": "Leandro Trossard",
          "jersey": "19",
          "position": null,
          "formation_place": null,
          "minute_on": 74,
          "minute_off": null,
          "goals": 0,
          "assists": 0,
          "yellow_cards": 0,
          "red_cards": 0
        }
      ],
      "unused_substitutes": [
        {
          "player_id": "178077",
          "name": "Christian Nørgaard",
          "jersey": "16"
        },
        {
          "player_id": "217289",
          "name": "Gabriel Jesus",
          "jersey": "9"
        },
        {
          "player_id": "169532",
          "name": "Kepa Arrizabalaga",
          "jersey": "13"
        }
      ]
    }
  ]
}