# NBA API: Get scores > 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. Unofficial. Not affiliated with or endorsed by NBA. - Page: https://fous.com/methods/nba.com/get-scores - Method: `nba.com/get_scores`, version 1 - Website: nba.com - Returns: date, start time, teams, scores, status, quarter, clock, TV channels, arena, city, game link, game id - 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 | `"2025-04-01"` | First NBA calendar date, for example 2026-10-03. Defaults to today in US Eastern time. | | `days` | integer | no | `2` | Number of calendar days to include, for example 7 (one week). Default 1. | | `team` | string | no | `"Celtics"` | Keep only this team’s games, for example Boston Celtics or Celtics. | | `time_zone` | string | no | `"America/Los_Angeles"` | Time zone for game start times, for example America/Los_Angeles. Defaults to US Eastern. Default "America/New_York". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "date": "2025-04-01", "days": 2, "team": "Celtics", "time_zone": "America/Los_Angeles" } ``` Its output: ```json { "games": [ { "city": "Boston", "date": "2025-04-02", "arena": "TD Garden", "clock": null, "status": "final", "game_id": "0022401106", "quarter": null, "away_team": "Miami Heat", "game_link": "https://www.nba.com/game/mia-vs-bos-0022401106", "home_team": "Boston Celtics", "away_score": 124, "home_score": 103, "start_time": "2025-04-02T16:30:00-07:00", "tv_channels": [ "NBCSB", "FDSNSU", "Elta" ] } ] } ``` ## 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":"nba.com/get_scores","input":{"date":"2025-04-01","days":2,"team":"Celtics","time_zone":"America/Los_Angeles"}}' ``` 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 NBA games are on for October 15, 2026 and what time do they tip off in Pacific time? - Show me the Lakers schedule and scores for the next week - Did the Celtics win last night, and what was the final score? - Give me every NBA game this weekend with TV channels and arena names - Which games are live right now in the NBA, with the current quarter and clock? ## Input schema ```json { "type": "object", "properties": { "date": { "type": "string", "description": "First NBA calendar date, for example 2026-10-03. Defaults to today in US Eastern time." }, "days": { "type": "integer", "default": 1, "maximum": 7, "minimum": 1, "description": "Number of calendar days to include, for example 7 (one week)." }, "team": { "type": "string", "description": "Keep only this team’s games, for example Boston Celtics or Celtics." }, "time_zone": { "type": "string", "default": "America/New_York", "description": "Time zone for game start times, for example America/Los_Angeles. Defaults to US Eastern." } } } ``` ## Output schema ```json { "type": "object", "required": [ "games" ], "properties": { "games": { "type": "array", "items": { "type": "object", "properties": { "city": { "type": [ "string", "null" ] }, "date": { "type": "string" }, "arena": { "type": [ "string", "null" ] }, "clock": { "type": [ "string", "null" ] }, "status": { "enum": [ "scheduled", "live", "final" ], "type": "string" }, "game_id": { "type": "string" }, "quarter": { "type": [ "string", "null" ] }, "away_team": { "type": "string" }, "game_link": { "type": "string" }, "home_team": { "type": "string" }, "away_score": { "type": [ "integer", "null" ] }, "home_score": { "type": [ "integer", "null" ] }, "start_time": { "type": [ "string", "null" ] }, "tv_channels": { "type": "array", "items": { "type": "string" } } } } } } } ``` ## See more - [NBA API: Get box score](https://fous.com/methods/nba.com/get-box-score.md): Returns the NBA box score for a game between two teams on a date; without a date, their most recent matchup, including Summer League and games in progress. - [NBA API: Get standings](https://fous.com/methods/nba.com/get-standings.md): Returns NBA regular-season standings for a season, with Eastern and Western Conference teams in rank order. Defaults to the season shown on the NBA standings page. - [NBA API: Get player by name](https://fous.com/methods/nba.com/get-player.md): Looks up an NBA player by name, including retired players, and returns the bio and regular-season per-game averages for the reported season and career. - [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. - [MLB API: Get scores and schedule](https://fous.com/methods/mlb.com/get-scores.md): 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. - [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. - [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. - [All NBA methods](https://fous.com/methods/nba.com.md)