# MLB API: Get scores and schedule > Lists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone. Unofficial. Not affiliated with or endorsed by MLB. - Page: https://fous.com/methods/mlb.com/get-scores - Method: `mlb.com/get_scores`, version 1 - Website: mlb.com - Returns: games with date, start time, teams, runs, status, inning, pitchers, TV channels, ballpark and game link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `date` | string | no | `"2026-09-29"` | First calendar date to show, for example 2026-09-29. Defaults to today. | | `days` | integer | no | `1` | Number of consecutive calendar days to show, for example 7. Default 1. | | `team` | string | no | | Team name to include, for example New York Yankees or Yankees. | | `time_zone` | string | no | | Time zone for game start times, for example US Eastern or America/Los_Angeles. Default "US Eastern". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "date": "2026-09-29", "days": 1 } ``` Its output: ```json { "games": [ { "date": "2026-09-29", "inning": null, "status": "final", "game_id": 849845, "ballpark": "Truist Park", "away_runs": 3, "away_team": "Philadelphia Phillies", "game_link": "https://www.mlb.com/gameday/849845", "home_runs": 5, "home_team": "Atlanta Braves", "start_time": "2026-09-29T14:00:00-04:00", "tv_channels": [ "NBC/Peacock", "Universo/Peacock" ], "losing_pitcher": "Jhoan Duran", "winning_pitcher": "Dylan Lee", "away_probable_pitcher": null, "home_probable_pitcher": null }, { "date": "2026-09-29", "inning": null, "status": "final", "game_id": 849849, "ballpark": "Daikin Park", "away_runs": 6, "away_team": "Chicago White Sox", "game_link": "https://www.mlb.com/gameday/849849", "home_runs": 3, "home_team": "Houston Astros", "start_time": "2026-09-29T17:00:00-04:00", "tv_channels": [ "Peacock/NBCSN", "Universo/Peacock" ], "losing_pitcher": "AJ Blubaugh", "winning_pitcher": "Jordan Hicks", "away_probable_pitcher": null, "home_probable_pitcher": null }, { "date": "2026-09-29", "inning": null, "status": "final", "game_id": 849851, "ballpark": "Yankee Stadium", "away_runs": 0, "away_team": "Boston Red Sox", "game_link": "https://www.mlb.com/gameday/849851", "home_runs": 9, "home_team": "New York Yankees", "start_time": "2026-09-29T20:00:00-04:00", "tv_channels": [ "NBC/Peacock", "Universo/Peacock" ], "losing_pitcher": "Payton Tolle", "winning_pitcher": "Cam Schlittler", "away_probable_pitcher": null, "home_probable_pitcher": null } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"mlb.com/get_scores","input":{"date":"2026-09-29","days":1}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What MLB games are on for 2026-09-29 and what are the current scores? - Show me Yankees games this week with start times in Pacific time - Any Dodgers results from yesterday on mlb.com, including the pitchers? - List every MLB game over the next seven days starting 2026-10-02, times in America/Chicago - Which TV channels are showing the Cubs game today and what inning is it in? ## Input schema ```json { "type": "object", "required": [], "properties": { "date": { "type": "string", "description": "First calendar date to show, for example 2026-09-29. Defaults to today." }, "days": { "type": "integer", "default": 1, "maximum": 7, "minimum": 1, "description": "Number of consecutive calendar days to show, for example 7." }, "team": { "type": "string", "description": "Team name to include, for example New York Yankees or Yankees." }, "time_zone": { "type": "string", "default": "US Eastern", "description": "Time zone for game start times, for example US Eastern or America/Los_Angeles." } } } ``` ## Output schema ```json { "type": "object", "required": [ "games" ], "properties": { "games": { "type": "array", "items": { "type": "object", "required": [ "date", "start_time", "away_team", "home_team", "away_runs", "home_runs", "status", "inning", "away_probable_pitcher", "home_probable_pitcher", "winning_pitcher", "losing_pitcher", "tv_channels", "ballpark", "game_link", "game_id" ], "properties": { "date": { "type": "string", "description": "Official game date." }, "inning": { "type": [ "string", "null" ], "description": "Current half-inning for live games." }, "status": { "type": "string", "description": "Scheduled, live, final, postponed or cancelled." }, "game_id": { "type": "integer", "description": "MLB game ID." }, "ballpark": { "type": [ "string", "null" ] }, "away_runs": { "type": [ "integer", "null" ] }, "away_team": { "type": "string" }, "game_link": { "type": "string" }, "home_runs": { "type": [ "integer", "null" ] }, "home_team": { "type": "string" }, "start_time": { "type": [ "string", "null" ], "description": "Scheduled start in the selected time zone; null when not announced." }, "tv_channels": { "type": "array", "items": { "type": "string" } }, "losing_pitcher": { "type": [ "string", "null" ] }, "winning_pitcher": { "type": [ "string", "null" ] }, "away_probable_pitcher": { "type": [ "string", "null" ] }, "home_probable_pitcher": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "description": "Games in start-time order." } }, "additionalProperties": false } ``` ## See more - [MLB API: Get standings](https://fous.com/methods/mlb.com/get-standings.md): Returns MLB regular-season division standings for a season: records, win percentage, games back, streak, last 10 games and wild-card games back. Defaults to the current year. - [MLB API: Get player stats](https://fous.com/methods/mlb.com/get-player-stats.md): Gets an MLB player's profile and regular-season hitting and pitching statistics for one season and for his career. Without a season it uses the current season, or the player's latest MLB season if he has no stats this year. - [NHL API: Get scores](https://fous.com/methods/nhl.com/get-scores.md): Lists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks. - [ESPN API: Get scores](https://fous.com/methods/espn.com/get-scores.md): Gets ESPN scores and the schedule for a league on a local day. You can filter by team, and start times are shown in your time zone. - [NBA API: Get scores](https://fous.com/methods/nba.com/get-scores.md): Gets NBA games for a date or up to seven days, using the NBA games calendar in US Eastern time. Each game has its score, status, start time, TV channels and venue. - [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games. - [NFL API: Get scores](https://fous.com/methods/nfl.com/get-scores.md): Gets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone. - [ESPN API: Get game summary](https://fous.com/methods/espn.com/get-game-summary.md): Finds the latest game between two teams, or their game on a given date, in major US leagues, MLS or the EPL. Returns the score, scoring by period, leading players, team stats and player box scores. - [All MLB methods](https://fous.com/methods/mlb.com.md)