get_games
Read-only
Use to list games with runs, hits and errors 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 mlb. One of: mlb, ncaabase. | |
| offset | No | ||
| season | No | Season (a year, e.g. 2025; default: the latest). | |
| status | No | ||
| season_type | No | regular or postseason (default both). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| games | Yes | ||
| next_offset | No |