list_games
Read-only
Use to list fixtures and results by season, stage, date, date range or club, newest first. For upcoming fixtures with lines use get_schedule; for one match in full use get_game. Costs 2 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | To date, YYYY-MM-DD. | |
| date | No | One date, YYYY-MM-DD (UTC). | |
| from | No | From date, YYYY-MM-DD. | |
| team | No | Club id, abbreviation or name. | |
| limit | No | Max matches (default 50). | |
| stage | No | league = league-table games (regular season, group stage, league phase); knockout = qualifying, knockout rounds and playoffs. | |
| league | No | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. | |
| offset | No | Page offset; use next_offset. | |
| season | No | Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest. | |
| status | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| games | Yes | ||
| next_offset | No |