list_games
2 creditsBasic lookupPOST /v1/list_games
Data refreshed · changelog
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 NWSL, Liga MX, Brazil and Argentina: 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.
leagueenum: soccer | mls | laliga | seriea | bundesliga | ligue1 | ucl | championship | nwsl | ligamx | uel | uecl | eredivisie | primeira | scotland | brazil | argentinaoptional- League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
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
Used in
- Anytime goalscorer prices by sportsbook: Anytime goalscorer prices by sportsbook for seven competitions, including MLS and the Champions League, since 2024, with the result. REST or MCP.
- Guide: How do I get Premier League scores and fixtures in Python?
Related endpoints
get_head_to_head2 cr
Takes the team this one returns.
Two clubs' meetings: record, goals and every result
get_game5 cr
Takes the game_id this one returns.
One match: score, both box scores, every player's line, key events, each book's line
get_lineups5 cr
Takes the game_id this one returns.
Formations, starting XIs, benches and substitutions with minutes
get_team_stats5 cr
Takes the team this one returns.
Per-match averages: goals, xG, shots, possession (missing for some leagues and seasons), passing, discipline, for and against
Try it
500 free credits every month: 250 calls to list_games, and no card.