Skip to content

list_games

2 creditsBasic lookupPOST /v1/list_games

Fixtures and results by season, stage, date, range or club

Use it when you want results or fixtures by season, date, club or stage (league or knockout), newest first.

Parameters

seasonnumber | stringoptional
Season by the year it starts: 2025 = 2025-26. MLS: the calendar year. Default: the latest.
stageenum: league | knockoutoptional
league = league-table games (regular season, group stage, league phase); knockout = qualifying, knockout rounds and playoffs.
teamstringoptional
Club id, abbreviation or name.
datestringoptional
One date, YYYY-MM-DD (UTC).
fromstringoptional
From date, YYYY-MM-DD.
tostringoptional
To date, YYYY-MM-DD.
statusenum: scheduled | finaloptional
limitintegeroptional
Max matches (default 50).
offsetintegeroptional
Page offset; use next_offset.

Notes

  • Over MCP, ask for it in plain English and the client calls list_games itself. Point any MCP client at https://mcp.strikerapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 2 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/list_games \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "team": "ARS",
  "season": 2025,
  "limit": 3
}'

Response

json
{
  "games": [
    {
      "game_id": "740968",
      "season": 2025,
      "stage": "Regular Season",
      "date": "2026-05-24",
      "starts_at": "2026-05-24T15:00:00.000Z",
      "status": "final",
      "status_detail": "FT",
      "home": {
        "team_id": "384",
        "abbrev": "CRY",
        "name": "Crystal Palace",
        "score": 1
      },
      "away": {
        "team_id": "359",
        "abbrev": "ARS",
        "name": "Arsenal",
        "score": 2
      },
      "result": "A",
      "neutral_site": null,
      "venue": "Selhurst Park",
      "city": "London",
      "attendance": null
    },
    {
      "game_id": "740956",
      "season": 2025,
      "stage": "Regular Season",
      "date": "2026-05-18",
      "starts_at": "2026-05-18T19:00:00.000Z",
      "status": "final",
      "status_detail": "FT",
      "home": {
        "team_id": "359",
        "abbrev": "ARS",
        "name": "Arsenal",
        "score": 1
      },
      "away": {
        "team_id": "379",
        "abbrev": "BUR",
        "name": "Burnley",
        "score": 0
      },
      "result": "H",
      "neutral_site": null,
      "venue": "Emirates Stadium",
      "city": "London",
      "attendance": 60274
    },
    {
      "game_id": "740955",
      "season": 2025,
      "stage": "Regular Season",
      "date": "2026-05-10",
      "starts_at": "2026-05-10T15:30:00.000Z",
      "status": "final",
      "status_detail": "FT",
      "home": {
        "team_id": "371",
        "abbrev": "WHU",
        "name": "West Ham United",
        "score": 0
      },
      "away": {
        "team_id": "359",
        "abbrev": "ARS",
        "name": "Arsenal",
        "score": 1
      },
      "result": "A",
      "neutral_site": null,
      "venue": "London Stadium",
      "city": "London",
      "attendance": 60429
    }
  ],
  "count": 3,
  "next_offset": 3
}

Response fields

games[]array
List of objects
games[].game_idstring
games[].seasonnumber
games[].stagestring
games[].datestring
games[].starts_atstring
games[].statusstring
games[].status_detailstring
games[].homeobject
games[].home.team_idstring
games[].home.abbrevstring
games[].home.namestring
games[].home.scorenumber
games[].awayobject
games[].away.team_idstring
games[].away.abbrevstring
games[].away.namestring
games[].away.scorenumber
games[].resultstring
games[].neutral_sitenull
games[].venuestring
games[].citystring
games[].attendancenull
countnumber
next_offsetnumber

Related endpoints

Try it

500 credits free on signup: 250 calls to list_games, and no card.