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 | finaloptionallimitintegeroptional- Max matches (default 50).
offsetintegeroptional- Page offset; use next_offset.
Notes
- Over MCP, ask for it in plain English and the client calls
list_gamesitself. Point any MCP client athttps://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_idstringgames[].seasonnumbergames[].stagestringgames[].datestringgames[].starts_atstringgames[].statusstringgames[].status_detailstringgames[].homeobjectgames[].home.team_idstringgames[].home.abbrevstringgames[].home.namestringgames[].home.scorenumbergames[].awayobjectgames[].away.team_idstringgames[].away.abbrevstringgames[].away.namestringgames[].away.scorenumbergames[].resultstringgames[].neutral_sitenullgames[].venuestringgames[].citystringgames[].attendancenullcountnumbernext_offsetnumber
Related endpoints
get_shot_map10 cr
Takes the game_id this one returns.
Shot map for a club, player or defence: every located shot with outcome and xG, plus zone totals
get_events10 cr
Takes the game_id this one returns.
Match events: goals, cards, substitutions, shots with location and xG, fouls, corners
get_team_stats5 cr
Takes the team this one returns.
Per-match averages: goals, xG, shots, possession, passing, discipline, for and against
get_ratings2 cr
Returns the team this one takes.
Our club Elo ratings, ranked
Try it
500 credits free on signup: 250 calls to list_games, and no card.