NBA provides up-to-seven-day schedules and scores, seasonal standings, player bios and available regular-season averages, plus matchup box scores, with undated matchups showing the latest.
Your information
Game date in YYYY-MM-DD, for example 2025-10-21. Defaults to their most recent game.
First team name, for example Lakers.
Second team name, for example Warriors.
Example results
- Date
- 2025-10-21
- Arena
- Paycom Center
- Score
- 124-125
- Status
- Final/OT2
- Game ID
- 0022500001
- Game Link
- nba.com
- Team 1
- Name
- Houston Rockets
- Score
- 124
- Players
Players Name Blocks Points Steals Assists Minutes Starter Rebounds Player ID Turnovers Plus Minus Field Goals Free Throws Three Pointers Jabari Smith Jr.0161041:45Yes51631095027-150-02-6Alperen Sengun1392748:53Yes1116305784912-2410-115-8Steven Adams040336:30Yes13203500321-42-20-0Kevin Durant0230347:03Yes9201142409-165-60-4Amen Thompson1181538:36Yes416417084-118-172-20-7Tari Eason130021:36No616311064-41-60-01-4Reed Sheppard191427:47No21642263203-111-22-7Clint Capela04107:52No0203991151-12-20-0Josh Okogie180119:58No216290060-81-35-61-3JD Davison0000—No01631120000-00-00-0Dorian Finney-Smith0000—No01627827000-00-00-0Jeff Green0000—No0201145000-00-00-0Kevon Harris0000—No01630284000-00-00-0Aaron Holiday0000—No01628988000-00-00-0Jae'Sean Tate0000—No01630256000-00-00-0- Points by Period
Points by Period Period Points Q130Q227Q322Q425OT111OT29
- Team 2
- Name
- Oklahoma City Thunder
- Score
- 125
- Players
Players Name Blocks Points Steals Assists Minutes Starter Rebounds Player ID Turnovers Plus Minus Field Goals Free Throws Three Pointers Luguentz Dort061545:15Yes61629652122-122-20-8Chet Holmgren0280238:30Yes716310963-111-174-42-5Isaiah Hartenstein062536:51Yes81628392192-52-20-1Cason Wallace0144541:39Yes71641717285-101-23-8Shai Gilgeous-Alexander2352547:13Yes516289833312-2610-141-9Jaylin Williams021112:53No016311190-31-50-00-4Aaron Wiggins0100120:32No11630598124-80-02-5Alex Caruso182330:11No216279360-153-90-02-6Brooks Barnhizer00002:15No016429640-20-00-00-0Ajay Mitchell1160214:36No21642349026-121-13-6Chris Youngblood00000:06No01642959000-00-00-0Ousmane Dieng0000—No01631172000-00-00-0- Points by Period
Points by Period Period Points Q127Q224Q324Q429OT111OT210
About NBA
NBA’s Get scores returns games, scores, start times, TV channels and venues for a date range, optionally filtered by team.
Get standings returns conference rankings and team records for a season; Get player returns a player bio and per-game averages by name.
Get box score returns game scores, player statistics and points by period for two teams, optionally selected by date.
Built by Fous from nba.com and checked automatically; it last passed a check on Sep 28, 2026. Fous is not affiliated with NBA.
Actions
Get box score
1 credit per runGet the NBA box score for a game between two teams. Without a date, returns their most recent matchup, including Summer League and games in progress.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Datedate | Date | Optional | Game date in YYYY-MM-DD, for example 2025-10-21. Defaults to their most recent game.Example: 2025-10-21 |
Team 1team_1 | Text | Required | First team name, for example Lakers.Example: Rockets |
Team 2team_2 | Text | Required | Second team name, for example Warriors.Example: Thunder |
What you get
| Field | Type | Description |
|---|---|---|
Datedate | Date | Example: 2025-10-21 |
Arenaarena | Text | Example: Paycom Center |
Scorescore | Text | Example: 124-125 |
Statusstatus | Text | Example: Final/OT2 |
Team 1team_1 | Details | |
Nameteam_1.name | Text | Example: Houston Rockets |
Scoreteam_1.score | Number | Example: 124 |
Playersteam_1.players | List | |
Points by Periodteam_1.points_by_period | List | |
Team 2team_2 | Details | |
Nameteam_2.name | Text | Example: Oklahoma City Thunder |
Scoreteam_2.score | Number | Example: 125 |
Playersteam_2.players | List | |
Points by Periodteam_2.points_by_period | List | |
Game IDgame_id | Text | Example: 0022500001 |
Game Linkgame_link | Text | Example: https://www.nba.com/game/0022500001/box-score |
Example result
For Date: 2025-10-21, Team 1: Rockets, Team 2: Thunder
{
"date": "2025-10-21",
"arena": "Paycom Center",
"score": "124-125",
"status": "Final/OT2",
"team_1": {
"name": "Houston Rockets",
"score": 124,
"players": [
{
"name": "Jabari Smith Jr.",
"blocks": 0,
"points": 16,
"steals": 1,
"assists": 0,
"minutes": "41:45",
"starter": true,
"rebounds": 5,
"player_id": 1631095,
"turnovers": 0,
"plus_minus": 2,
"field_goals": "7-15",
"free_throws": "0-0",
"three_pointers": "2-6"
}
],
"points_by_period": [
{
"period": "Q1",
"points": 30
}
]
},
"team_2": {
"name": "Oklahoma City Thunder",
"score": 125,
"players": [
{
"name": "Luguentz Dort",
"blocks": 0,
"points": 6,
"steals": 1,
"assists": 5,
"minutes": "45:15",
"starter": true,
"rebounds": 6,
"player_id": 1629652,
"turnovers": 1,
"plus_minus": 2,
"field_goals": "2-12",
"free_throws": "2-2",
"three_pointers": "0-8"
}
],
"points_by_period": [
{
"period": "Q1",
"points": 27
}
]
},
"game_id": "0022500001",
"game_link": "https://www.nba.com/game/0022500001/box-score"
}Get player
1 credit per runGet an NBA player’s bio and regular-season per-game averages by name, including retired players. Season averages are unavailable when the player has no current reported season.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Playerplayer | Text | Required | NBA player name, such as Stephen Curry.Example: Michael Jordan |
What you get
| Field | Type | Description |
|---|---|---|
Ageage | Number | Age in years.Example: 63 |
Namename | Text | Player’s full name.Example: Michael Jordan |
Teamteam | Text | Team shown on the NBA player profile.Example: Chicago Bulls |
Draftdraft | Text | Draft year, round and overall pick.Example: 1984 Round 1, Pick 3 |
Heightheight | Text | Height in feet and inches.Example: 6 ft 6 in |
Seasonseason | Text | Season associated with the season averages, such as 2025-26.Example: 2025-26 |
Countrycountry | Text | Country.Example: USA |
Positionposition | Text | Playing position.Example: Guard |
Height (cm)height_cm | Number | Height in centimeters.Example: 198.1 |
Player URLplayer_url | Text | NBA player page link.Example: https://www.nba.com/player/893/michael-jordan |
Date of Birthdate_of_birth | Text | Birth date in YYYY-MM-DD format.Example: 1963-02-17 |
Jersey Numberjersey_number | Text | Jersey number, preserving leading zeros.Example: 23 |
Nba Player IDnba_player_id | Number | NBA player identifier.Example: 893 |
Weight Poundsweight_pounds | Number | Weight in pounds.Example: 216 |
Career Averagescareer_averages | Value | Career regular-season per-game averages, or null if unavailable. |
Season Averagesseason_averages | Value | Regular-season per-game averages for the reported season, or null if unavailable. |
Years in Leagueyears_in_league | Number | NBA seasons of experience.Example: 15 |
Headshot Image URLheadshot_image_url | Text | NBA headshot image link.Example: https://cdn.nba.com/headshots/nba/latest/1040x760/893.png |
College or Last Clubcollege_or_last_club | Text | College or last club.Example: North Carolina |
Example result
For Player: Michael Jordan
{
"age": 63,
"name": "Michael Jordan",
"team": "Chicago Bulls",
"draft": "1984 Round 1, Pick 3",
"height": "6 ft 6 in",
"season": null,
"country": "USA",
"position": "Guard",
"height_cm": 198.1,
"player_url": "https://www.nba.com/player/893/michael-jordan",
"date_of_birth": "1963-02-17",
"jersey_number": "23",
"nba_player_id": 893,
"weight_pounds": 216,
"career_averages": {
"blocks": 0.8,
"points": 30.1,
"steals": 2.3,
"assists": 5.3,
"minutes": 38.3,
"rebounds": 6.2,
"games_played": 1072,
"field_goal_percentage": 49.7,
"free_throw_percentage": 83.5,
"three_point_percentage": 32.7
},
"season_averages": null,
"years_in_league": 15,
"headshot_image_url": "https://cdn.nba.com/headshots/nba/latest/1040x760/893.png",
"college_or_last_club": "North Carolina"
}Get scores
1 credit per runGet NBA games, scores, start times, TV channels and venues for a date or up to seven days. Dates follow the NBA games calendar in US Eastern time.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Datedate | Date | Optional | First NBA calendar date, for example 2026-10-03. Defaults to today in US Eastern time.Example: 2026-10-03 |
Daysdays | Number | Optional | Number of calendar days to include, for example 7 (one week).Example: 2 |
Teamteam | Text | Optional | Keep only this team’s games, for example Boston Celtics or Celtics.Example: Celtics |
Time Zonetime_zone | Text | Optional | Time zone for game start times, for example America/Los_Angeles. Defaults to US Eastern.Example: America/Los_Angeles |
What you get
| Field | Type | Description |
|---|---|---|
Gamesgames | List | |
Citygames[].city | Text | Example: Quebec City |
Dategames[].date | Date | NBA calendar date of the game.Example: 2026-10-03 |
Arenagames[].arena | Text | Example: Videotron Centre |
Clockgames[].clock | Text | Game clock when live. |
Statusgames[].status | Text | Example: Scheduled |
Game IDgames[].game_id | Text | Example: 0012600009 |
Quartergames[].quarter | Text | Current quarter or overtime when live. |
Away Teamgames[].away_team | Text | Example: Miami Heat |
Game Linkgames[].game_link | Link | Example: https://www.nba.com/game/mia-vs-tor-0012600009 |
Home Teamgames[].home_team | Text | Example: Toronto Raptors |
Away Scoregames[].away_score | Number | Example: 124 |
Home Scoregames[].home_score | Number | Example: 103 |
Start Timegames[].start_time | Date | Scheduled start in the requested time zone, or null if not announced.Example: 2026-10-03T19:00:00-04:00 |
Tv Channelsgames[].tv_channels | List | TV broadcasters listed on the game card. |
Example result
For Date: 2026-10-03
{
"games": [
{
"city": "Quebec City",
"date": "2026-10-03",
"arena": "Videotron Centre",
"clock": null,
"status": "scheduled",
"game_id": "0012600009",
"quarter": null,
"away_team": "Miami Heat",
"game_link": "https://www.nba.com/game/mia-vs-tor-0012600009",
"home_team": "Toronto Raptors",
"away_score": null,
"home_score": null,
"start_time": "2026-10-03T19:00:00-04:00",
"tv_channels": [
"NBA TV"
]
}
]
}Get standings
1 credit per runGet NBA regular-season standings in Eastern and Western Conference rank order for a season. Defaults to the season shown on NBA standings.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Seasonseason | Text | Optional | NBA season, such as "2025-26" or its starting year "2025". Defaults to the season displayed on the NBA standings page.Example: 2024-25 |
What you get
| Field | Type | Description |
|---|---|---|
Seasonseason | Text | Season shown in the standings. |
Eastern Conferenceeastern_conference | List | Eastern Conference teams in rank order. |
Rankeastern_conference[].rank | Number | Team position in the conference. |
Teameastern_conference[].team | Text | Team name. |
Winseastern_conference[].wins | Number | Games won. |
Losseseastern_conference[].losses | Number | Games lost. |
Streakeastern_conference[].streak | Text | Current consecutive wins or losses. |
Last 10eastern_conference[].last_10 | Text | Record in the last ten games. |
Page URLeastern_conference[].page_url | Text | NBA team page. |
Away Recordeastern_conference[].away_record | Text | Away wins and losses. |
Home Recordeastern_conference[].home_record | Text | Home wins and losses. |
Games Behindeastern_conference[].games_behind | Number | Games behind the conference leader. |
Clinch Statuseastern_conference[].clinch_status | Text | Clinch or elimination status when shown. |
Win Percentageeastern_conference[].win_percentage | Number | Fraction of games won. |
Western Conferencewestern_conference | List | Western Conference teams in rank order. |
Rankwestern_conference[].rank | Number | Team position in the conference. |
Teamwestern_conference[].team | Text | Team name. |
Winswestern_conference[].wins | Number | Games won. |
Losseswestern_conference[].losses | Number | Games lost. |
Streakwestern_conference[].streak | Text | Current consecutive wins or losses. |
Last 10western_conference[].last_10 | Text | Record in the last ten games. |
Page URLwestern_conference[].page_url | Text | NBA team page. |
Away Recordwestern_conference[].away_record | Text | Away wins and losses. |
Home Recordwestern_conference[].home_record | Text | Home wins and losses. |
Games Behindwestern_conference[].games_behind | Number | Games behind the conference leader. |
Clinch Statuswestern_conference[].clinch_status | Text | Clinch or elimination status when shown. |
Win Percentagewestern_conference[].win_percentage | Number | Fraction of games won. |
For developers
Run this workflow from your own code. In Studio, turn on Developer mode and create an API key.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 120 \
-H "Authorization: Bearer $FOUS_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@nba",
"visibility": "public",
"operation": "get_box_score",
"version": 1,
"input": {
"date": "2025-10-21",
"team_1": "Rockets",
"team_2": "Thunder"
},
"response": {
"format": "json"
}
}'What you can do with it
- Track game scores and start times by team.
- Compare conference standings across seasons.
- Review a player’s bio and regular-season averages.
- Analyze player statistics and scoring by period in a matchup.
Questions
Is Fous affiliated with NBA?
No. Fous is not affiliated with NBA. This workflow reads the public nba.com website and returns its data.
How much does it cost?
Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.
Do I need a NBA account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from nba.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 28, 2026.
What are the scores for a date or team?
Get scores returns games and scores for a date or date range, with an optional team filter.
Which teams lead each conference?
Get standings returns Eastern and Western Conference teams in rank order for a season.
What did players record in a matchup?
Get box score returns player statistics and points by period for two teams.