Skip to content

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.

nba.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by NBA.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Date optionaldate

First NBA calendar date, for example 2026-10-03. Defaults to today in US Eastern time.

2025-04-01

Days optionaldays

Number of calendar days to include, for example 7 (one week).

2

Whole number from 1 to 7. Default 1.

Team optionalteam

Keep only this team’s games, for example Boston Celtics or Celtics.

Celtics

Time Zone optionaltime_zone

Time zone for game start times, for example America/Los_Angeles. Defaults to US Eastern.

America/Los_Angeles

Default America/New_York.

Output

From a run on Oct 23, 2026, shortened for this page.
{  "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"      ]    }  ]}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
nba.com/get_scores
Returns
date, start time, teams, scores, status, quarter, clock, TV channels, arena, city, game link, game id

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method nba.com/get_scores with the inputs above.

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?
  • 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.com/get_box_score
  • 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.com/get_standings
  • 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.

    nba.com/get_player
  • Lists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks.

    nhl.com/get_scores
  • 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.

    espn.com/get_scores
  • 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.

    mlb.com/get_scores
  • 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.

    nfl.com/get_scores
  • 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.

    sports.yahoo.com/get_scores