list_games
Read-only
Use to list games with scores by season, date, date range or team, newest first. For upcoming games with lines use get_schedule; for one game's box score 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 (US Eastern). | |
| from | No | From date, YYYY-MM-DD. | |
| team | No | Team id or abbreviation. | |
| limit | No | Max games (default 50). | |
| league | No | League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw. | |
| offset | No | Page offset; use next_offset. | |
| season | No | Season by the year it ends: 2025 = 2024-25. | |
| status | No | ||
| season_type | No | regular, postseason, play_in or preseason. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| games | Yes | ||
| next_offset | No |