Schedules
This guide explains how to pull and display schedule information.
Prerequisite - Accessing Available Seasons
To avoid confusion and ensure you're accessing available data, refer to our Seasons feed. This resource lists all the seasons for which we have data.
For example: To ensure data availability for future seasons, such as a schedule in advance of when a season begins, first check the Seasons feed to verify that data for that specific season is already provided.
Starting with this feed can prevent unnecessary errors and streamline your data retrieval process.
Starting Year for Each Season
It's important to note that the
seasonparameter uses the starting year of the season; for example, to retrieve data for the 2024-25 NBA season, you would use2024as the value for the season parameter.
Scheduling Feeds Available
Accessing the schedule is fundamental to your integration and essential in critical scenarios. For instance, if you need to retrieve live game data, you'll first need to pull a schedule feed to obtain the game IDs for the specific games you're targeting.
You can access NBA scheduling data using the following feeds:
- Daily Schedule - This feed provides the date, time, location, and other event details for every game scheduled within the NBA's league-defined day. It's particularly useful if you're looking for the schedule of games on a specific day.
Note: A league-defined day refers to the 24-hour period set by the NBA during which all scheduled games and events for that day occur. - Schedule - Provides the date, time, location, and other event details for every match-up throughout the entire NBA season.
- Series Schedule - Playoff participant information as well as the date, time, location, and other event details for every match-up taking place for the entire playoffs.
Example - Daily Schedule
{
"date": "2024-11-04",
"league": {
"id": "4353138d-4c22-4396-95d8-5f587d2df25c",
"name": "NBA",
"alias": "NBA"
},
"games": [
{
"id": "d3bfaf12-5080-4864-be83-55cc65fe38c2",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T00:00:00Z",
"track_on_court": true,
"sr_id": "sr:match:52631821",
"reference": "0022400154",
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Central"
},
"venue": {
"id": "42cddf7a-0e1f-5f91-ae6f-c620582fdb01",
"name": "Rocket Mortgage FieldHouse",
"capacity": 19432,
"address": "1 Center Court",
"city": "Cleveland",
"state": "OH",
"zip": "44115",
"country": "USA",
"sr_id": "sr:venue:6132",
"location": {
"lat": "41.496565",
"lng": "-81.688265"
}
},
"broadcasts": [
{
"network": "NBA TV",
"type": "TV",
"locale": "National",
"channel": "216"
},
{
"network": "FDS-OH",
"type": "TV",
"locale": "Home",
"channel": "660"
},
{
"network": "FDS-WI",
"type": "TV",
"locale": "Away",
"channel": "669"
}
],
"home": {
"name": "Cleveland Cavaliers",
"alias": "CLE",
"id": "583ec773-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3432",
"reference": "1610612739"
},
"away": {
"name": "Milwaukee Bucks",
"alias": "MIL",
"id": "583ecefd-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3410",
"reference": "1610612749"
}
},
{
"id": "81724793-5368-45eb-b50f-503255f22506",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T00:15:00Z",
"track_on_court": true,
"sr_id": "sr:match:52631177",
"reference": "0022400155",
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Pacific"
},
"venue": {
"id": "f62d5b49-d646-56e9-ba60-a875a00830f8",
"name": "Capital One Arena",
"capacity": 20356,
"address": "601 F Street NW",
"city": "Washington",
"state": "DC",
"zip": "20004",
"country": "USA",
"sr_id": "sr:venue:6016",
"location": {
"lat": "38.898056",
"lng": "-77.020833"
}
},
"broadcasts": [
{
"network": "NBCS-BA",
"type": "TV",
"locale": "Away",
"channel": "696"
},
{
"network": "MNMT",
"type": "TV",
"locale": "Home",
"channel": "642"
}
],
"home": {
"name": "Washington Wizards",
"alias": "WAS",
"id": "583ec8d4-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3431",
"reference": "1610612764"
},
"away": {
"name": "Golden State Warriors",
"alias": "GSW",
"id": "583ec825-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3428",
"reference": "1610612744"
}
},
{
"id": "d45d894a-513a-4ce9-aa4b-12835395cd76",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T00:30:00Z",
"track_on_court": true,
"sr_id": "sr:match:52630321",
"reference": "0022400156",
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Pacific"
},
"venue": {
"id": "5a9ddefc-2267-4fd1-8d6e-0f82163ce8bd",
"name": "Little Caesars Arena",
"capacity": 20491,
"address": "2645 Woodward Avenue",
"city": "Detroit",
"state": "MI",
"zip": "48201",
"country": "USA",
"sr_id": "sr:venue:21782",
"location": {
"lat": "42.341172",
"lng": "-83.054911"
}
},
"broadcasts": [
{
"network": "SportsNet LA",
"type": "TV",
"locale": "Away",
"channel": "690"
},
{
"network": "FDS-DET",
"type": "TV",
"locale": "Home",
"channel": "663"
}
],
"home": {
"name": "Detroit Pistons",
"alias": "DET",
"id": "583ec928-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3424",
"reference": "1610612765"
},
"away": {
"name": "Los Angeles Lakers",
"alias": "LAL",
"id": "583ecae2-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3427",
"reference": "1610612747"
}
},
{
"id": "06e79aa0-cab6-4430-a624-01a83b037d62",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T00:45:00Z",
"track_on_court": true,
"sr_id": "sr:match:52630719",
"reference": "0022400157",
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Eastern"
},
"venue": {
"id": "fd21f639-8a47-51ac-a5dd-590629d445cf",
"name": "State Farm Arena",
"capacity": 18118,
"address": "One Philips Drive",
"city": "Atlanta",
"state": "GA",
"zip": "30303",
"country": "USA",
"sr_id": "sr:venue:6916",
"location": {
"lat": "33.757162",
"lng": "-84.396352"
}
},
"broadcasts": [
{
"network": "NBCS-BOS",
"type": "TV",
"locale": "Away",
"channel": "630"
},
{
"network": "FDS-SE(ATL)",
"type": "TV",
"locale": "Home",
"channel": "649"
}
],
"home": {
"name": "Atlanta Hawks",
"alias": "ATL",
"id": "583ecb8f-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3423",
"reference": "1610612737"
},
"away": {
"name": "Boston Celtics",
"alias": "BOS",
"id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3422",
"reference": "1610612738"
}
},
{
"id": "1b7a853b-c989-4864-ab05-1d8b365355e8",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T01:00:00Z",
"track_on_court": true,
"sr_id": "sr:match:52630563",
"reference": "0022400158",
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Central"
},
"venue": {
"id": "7a330bcd-ac0f-50ca-bc29-2460e5c476b3",
"name": "Barclays Center",
"capacity": 17732,
"address": "620 Atlantic Avenue",
"city": "Brooklyn",
"state": "NY",
"zip": "11217",
"country": "USA",
"sr_id": "sr:venue:36132",
"location": {
"lat": "40.682957",
"lng": "-73.975165"
}
},
"broadcasts": [
{
"network": "YES",
"type": "TV",
"locale": "Home",
"channel": "631"
},
{
"network": "FDS-SE(MEM)",
"type": "TV",
"locale": "Away",
"channel": "649"
}
],
"home": {
"name": "Brooklyn Nets",
"alias": "BKN",
"id": "583ec9d6-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3436",
"reference": "1610612751"
},
"away": {
"name": "Memphis Grizzlies",
"alias": "MEM",
"id": "583eca88-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3415",
"reference": "1610612763"
}
},
{
"id": "6a06f73f-215d-470a-9fb5-fa5d350e65df",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T01:15:00Z",
"track_on_court": true,
"sr_id": "sr:match:52631499",
"reference": "0022400159",
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Pacific"
},
"venue": {
"id": "b67d5f09-28b2-5bc6-9097-af312007d2f4",
"name": "Kaseya Center",
"capacity": 19600,
"address": "601 Biscayne Boulevard",
"city": "Miami",
"state": "FL",
"zip": "33132",
"country": "USA",
"sr_id": "sr:venue:6928",
"location": {
"lat": "25.781389",
"lng": "-80.188056"
}
},
"broadcasts": [
{
"network": "NBCS-CA",
"type": "TV",
"locale": "Away",
"channel": "698"
},
{
"network": "FDS-SUN",
"type": "TV",
"locale": "Home",
"channel": "653"
}
],
"home": {
"name": "Miami Heat",
"alias": "MIA",
"id": "583ecea6-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3435",
"reference": "1610612748"
},
"away": {
"name": "Sacramento Kings",
"alias": "SAC",
"id": "583ed0ac-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3413",
"reference": "1610612758"
}
},
{
"id": "246124e4-d91d-4776-bc4e-fee0b6d8c81b",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T01:30:00Z",
"track_on_court": true,
"sr_id": "sr:match:52631535",
"reference": "0022400160",
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Mountain"
},
"venue": {
"id": "38911649-acfd-551a-949b-68f0fcaa44e7",
"name": "United Center",
"capacity": 20917,
"address": "1901 W Madison Street",
"city": "Chicago",
"state": "IL",
"zip": "60612",
"country": "USA",
"sr_id": "sr:venue:5964",
"location": {
"lat": "41.880675",
"lng": "-87.674091"
}
},
"broadcasts": [
{
"network": "KJZZ",
"type": "TV",
"locale": "Away"
},
{
"network": "CHSN",
"type": "TV",
"locale": "Home",
"channel": "665"
}
],
"home": {
"name": "Chicago Bulls",
"alias": "CHI",
"id": "583ec5fd-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3409",
"reference": "1610612741"
},
"away": {
"name": "Utah Jazz",
"alias": "UTA",
"id": "583ece50-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3434",
"reference": "1610612762"
}
},
{
"id": "fa66fc56-d8f2-4fac-a002-d922fbac7f8a",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T01:45:00Z",
"track_on_court": true,
"sr_id": "sr:match:52630887",
"reference": "0022400161",
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "5b239206-57ce-50aa-baaa-627f3349dfdc",
"name": "Toyota Center",
"capacity": 18500,
"address": "1510 Polk Street",
"city": "Houston",
"state": "TX",
"zip": "77002",
"country": "USA",
"sr_id": "sr:venue:6134",
"location": {
"lat": "29.750751",
"lng": "-95.362049"
}
},
"broadcasts": [
{
"network": "SCHN",
"type": "TV",
"locale": "Home",
"channel": "674"
},
{
"network": "MSG",
"type": "TV",
"locale": "Away",
"channel": "634"
}
],
"home": {
"name": "Houston Rockets",
"alias": "HOU",
"id": "583ecb3a-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3412",
"reference": "1610612745"
},
"away": {
"name": "New York Knicks",
"alias": "NYK",
"id": "583ec70e-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3421",
"reference": "1610612752"
}
},
{
"id": "87256326-73f1-4dcc-8e5a-fc23db513237",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T02:00:00Z",
"track_on_court": true,
"sr_id": "sr:match:52630799",
"reference": "0022400162",
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "7aed802e-3562-5b73-af1b-3859529f9b95",
"name": "Target Center",
"capacity": 19356,
"address": "600 First Avenue North",
"city": "Minneapolis",
"state": "MN",
"zip": "55403",
"country": "USA",
"sr_id": "sr:venue:6930",
"location": {
"lat": "44.979444",
"lng": "-93.276111"
}
},
"broadcasts": [
{
"network": "FDS-N",
"type": "TV",
"locale": "Home",
"channel": "668"
},
{
"network": "FDS-SE(CHA)",
"type": "TV",
"locale": "Away",
"channel": "649"
}
],
"home": {
"name": "Minnesota Timberwolves",
"alias": "MIN",
"id": "583eca2f-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3426",
"reference": "1610612750"
},
"away": {
"name": "Charlotte Hornets",
"alias": "CHA",
"id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3430",
"reference": "1610612766"
}
},
{
"id": "585a39d7-48d0-4e97-b40a-2dfc6ca322e9",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T02:15:00Z",
"track_on_court": true,
"sr_id": "sr:match:52631665",
"reference": "0022400163",
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "a13af216-4409-5021-8dd5-255cc71bffc3",
"name": "Paycom Center",
"capacity": 18203,
"address": "100 W. Reno Avenue",
"city": "Oklahoma City",
"state": "OK",
"zip": "73102",
"country": "USA",
"sr_id": "sr:venue:6934",
"location": {
"lat": "35.463333",
"lng": "-97.515"
}
},
"broadcasts": [
{
"network": "FDS-OK",
"type": "TV",
"locale": "Home",
"channel": "675"
},
{
"network": "FDS-FL",
"type": "TV",
"locale": "Away",
"channel": "654"
}
],
"home": {
"name": "Oklahoma City Thunder",
"alias": "OKC",
"id": "583ecfff-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3418",
"reference": "1610612760"
},
"away": {
"name": "Orlando Magic",
"alias": "ORL",
"id": "583ed157-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3437",
"reference": "1610612753"
}
},
{
"id": "eabef3d3-a390-42d6-9175-0dcb450641f7",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T02:30:00Z",
"track_on_court": true,
"sr_id": "sr:match:52630035",
"reference": "0022400164",
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Pacific"
},
"venue": {
"id": "6ec47e31-f778-5319-b6c4-3254e076ba0e",
"name": "Smoothie King Center",
"capacity": 16867,
"address": "1501 Girod Street",
"city": "New Orleans",
"state": "LA",
"zip": "70113",
"country": "USA",
"sr_id": "sr:venue:6932",
"location": {
"lat": "29.948889",
"lng": "-90.081944"
}
},
"broadcasts": [
{
"network": "KATU",
"type": "TV",
"locale": "Away"
},
{
"network": "Gulf Coast Sports",
"type": "TV",
"locale": "Home"
}
],
"home": {
"name": "New Orleans Pelicans",
"alias": "NOP",
"id": "583ecc9a-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:5539",
"reference": "1610612740"
},
"away": {
"name": "Portland Trail Blazers",
"alias": "POR",
"id": "583ed056-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3414",
"reference": "1610612757"
}
},
{
"id": "d48270db-f2cd-48ae-a225-2a66c7cf3492",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T02:45:00Z",
"track_on_court": true,
"sr_id": "sr:match:52631361",
"reference": "0022400165",
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "401ba62f-19b5-5bfc-84d6-021772943311",
"name": "American Airlines Center",
"capacity": 19200,
"address": "2500 Victory Avenue",
"city": "Dallas",
"state": "TX",
"zip": "75219",
"country": "USA",
"sr_id": "sr:venue:5988",
"location": {
"lat": "32.79087",
"lng": "-96.810338"
}
},
"broadcasts": [
{
"network": "KFAA",
"type": "TV",
"locale": "Home"
},
{
"network": "FDS-IN",
"type": "TV",
"locale": "Away",
"channel": "671-4"
}
],
"home": {
"name": "Dallas Mavericks",
"alias": "DAL",
"id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3411",
"reference": "1610612742"
},
"away": {
"name": "Indiana Pacers",
"alias": "IND",
"id": "583ec7cd-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3419",
"reference": "1610612754"
}
},
{
"id": "6df6fac6-6860-4025-befb-ddec8f7d6364",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T03:00:00Z",
"track_on_court": true,
"sr_id": "sr:match:52632029",
"reference": "0022400166",
"time_zones": {
"venue": "US/Mountain",
"home": "US/Mountain",
"away": "US/Eastern"
},
"venue": {
"id": "1a28ef88-76c9-5bcc-b4ee-51d30ca98f4f",
"name": "Ball Arena",
"capacity": 19520,
"address": "1000 Chopper Circle",
"city": "Denver",
"state": "CO",
"zip": "80204",
"country": "USA",
"sr_id": "sr:venue:5976",
"location": {
"lat": "39.749034",
"lng": "-105.007604"
}
},
"broadcasts": [
{
"network": "ALT",
"type": "TV",
"locale": "Home",
"channel": "681"
},
{
"network": "SportsNet",
"type": "TV",
"locale": "International"
}
],
"home": {
"name": "Denver Nuggets",
"alias": "DEN",
"id": "583ed102-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3417",
"reference": "1610612743"
},
"away": {
"name": "Toronto Raptors",
"alias": "TOR",
"id": "583ecda6-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3433",
"reference": "1610612761"
}
},
{
"id": "98f02baf-1b18-4978-84fb-f7276bc1882c",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T03:15:00Z",
"track_on_court": true,
"sr_id": "sr:match:52630747",
"reference": "0022400167",
"time_zones": {
"venue": "US/Arizona",
"home": "US/Arizona",
"away": "US/Eastern"
},
"venue": {
"id": "1d2e59b2-2479-5f84-a6a7-e82f65dd8442",
"name": "Footprint Center",
"capacity": 18422,
"address": "201 E. Jefferson Street",
"city": "Phoenix",
"state": "AZ",
"zip": "85004",
"country": "USA",
"sr_id": "sr:venue:6938",
"location": {
"lat": "33.445833",
"lng": "-112.071389"
}
},
"broadcasts": [
{
"network": "NBA TV",
"type": "TV",
"locale": "National",
"channel": "216"
},
{
"network": "AZFamily",
"type": "TV",
"locale": "Home"
},
{
"network": "NBCS-PH",
"type": "TV",
"locale": "Away"
}
],
"home": {
"name": "Phoenix Suns",
"alias": "PHX",
"id": "583ecfa8-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3416",
"reference": "1610612756"
},
"away": {
"name": "Philadelphia 76ers",
"alias": "PHI",
"id": "583ec87d-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3420",
"reference": "1610612755"
}
},
{
"id": "961ac6f8-9cfd-4c24-9599-5a23febac867",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-05T03:30:00Z",
"track_on_court": true,
"sr_id": "sr:match:52631481",
"reference": "0022400168",
"time_zones": {
"venue": "US/Pacific",
"home": "US/Pacific",
"away": "US/Central"
},
"venue": {
"id": "cf7b61b7-a868-4b39-ac60-ecad61e0721a",
"name": "Intuit Dome",
"capacity": 18000,
"address": "3930 W Century Blvd",
"city": "Inglewood",
"state": "CA",
"zip": "90303",
"country": "USA",
"sr_id": "sr:venue:79291"
},
"broadcasts": [
{
"network": "KTLA",
"type": "TV",
"locale": "Home"
},
{
"network": "FDS-SW",
"type": "TV",
"locale": "Away",
"channel": "676"
}
],
"home": {
"name": "LA Clippers",
"alias": "LAC",
"id": "583ecdfb-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3425",
"reference": "1610612746"
},
"away": {
"name": "San Antonio Spurs",
"alias": "SAS",
"id": "583ecd4f-fb46-11e1-82cb-f4ce4684ea4c",
"sr_id": "sr:team:3429",
"reference": "1610612759"
}
}
]
}
This response from the NBA Daily Schedule endpoint gives you a detailed list of games scheduled for November 4, 2024. Each game includes essential information like game IDs, start times, venues, and broadcast networks. You can use this data to retrieve the game IDs you need for pulling live game data or to display game details on your platform. This is especially useful for building a feature that tracks games in real time or displays the daily schedule with broadcast information for users.
How to Load Schedule Data
- Find the correct season number: The
seasonparameter uses the starting year of the season; for example, to retrieve data for the 2024-25 NBA season, you would use2024as the value for the season parameter. You can use the Seasons feed to see the most current season we have data for. - If applicable, utilize the correct season type for the data you want. Available season types for NBA include:
REG: Regular Season
Refers to games that take place during the standard, scheduled part of the season.PST: Post-Season
Refers to playoff games or games that occur after the conclusion of the regular season.IST: In-Season Tournament
Refers to special tournaments that are held during the regular season but are distinct from regular season games.PIT: Play-In Tournament
Refers to tournaments held to determine which teams will advance to the playoffs.
- Set your calls based on the update frequency of the schedule feeds:
- Schedule feeds have a TTL/Cache of 10 seconds.
- Pull them every hour or less depending on your use case.
Note: These feeds should be used for schedule info prior to a game start. For status of a live game, reference a "game" endpoint. - Schedule information is updated in realtime as changes are made.
- Monitor updates to the current schedule: You can do this using the Daily Change Log feed. This feed provides IDs and timestamps for schedules as well as players, game statistics, and standings that have been modified on a given date. Learn more in the Daily Change Log section.
Schedule Releases
Schedules are typically released during the following timeframes:
- Preseason (PRE): Released in early August.
- Regular Season (REG): Released mid-August.
- Postseason (PST): Announced near the end of the regular season, often in April, once playoff standings are set.
- Play-In Tournament (PIT): Released at the end of the regular season, typically just before the postseason schedule, depending on final standings.
Update Frequency for Schedules
The NBA schedule is first uploaded within a day of its official release. Throughout the season, our Production team continuously monitors updates from various sources and tools, making adjustments to game details such as start times, broadcast information, and adding new games as they are announced.
Displaying Team Schedules
A great way to utilize the schedule endpoints is to display a specific team's schedule on your platform. By pulling data such as game dates, times, and venues, you can create a clear and accessible view of upcoming matchups for your users.
Suggested Steps:
-
Retrieve the full schedule data: Use the schedule or daily schedule endpoints to pull raw data, which includes game details like team names, game IDs, dates, times, and venues.
-
Filter by team: Once the data is retrieved, you can filter the schedule by the team's unique ID (e.g.,
team_idorsr_id). This will isolate only the games where the selected team is either the home or away team. -
Sort the games chronologically: After filtering for the team, you can sort the games by date and time (
scheduledfield) to ensure the schedule is displayed in the correct order. -
Format the data for display: Extract relevant data fields, such as opponent team, game date, venue, and broadcast information. Format this data into a readable structure like a table, list, or calendar.
-
Handle time zones and broadcast info: Use the
time_zonesandbroadcastsfields to ensure the correct time and broadcast network are displayed to users, potentially converting times to the user's local time zone.
Example - Schedule for the Minnesota Timberwolves:
This is an example of how you can render a team-specific NBA schedule using data from the schedule API. You can create a dropdown that lets users select a team (e.g., Timberwolves), and you can have the schedule update to reflect the selected team. The list shows each game’s date, opponent, and time, making it easy for users to follow their team. You can filter the schedule by team ID and display the results in a clean, user-friendly format like this one.
Accessing Headshots and Team Logos
To access team logos and player headshots, use the Images API.
Showcasing Recent Games
The following visual showcases recent game data for the Minnesota Timberwolves.
This example shows how you can use the schedule feeds to showcase recent preseason games. In the image, there's a clear separation between the regular season and preseason games for the Timberwolves, with each preseason game's results, including final scores and win/loss status, clearly displayed. You can achieve a similar setup by pulling the schedule feed for both preseason and regular games, filtering the data by team and closed games, and displaying key details like date, opponent, and result.
Game Status
For detailed information on game statuses, including definitions and code examples for each status, please visit our Game Status Workflow page.
Daily Change Log
The Daily Change Log endpoint allows for efficient tracking of daily changes to the NBA API without depleting your API call limits. It updates you on significant changes like schedule adjustments, game results, player updates (such as name or number changes), and team modifications.
To use the Daily Change Log feed for monitoring changes to match schedules:
- Identify the Change Type: Updates to scheduling information are displayed using the
schedulenode. - Pull Detailed Data: Use game IDs to retrieve specifics on the schedule update.
- Verify Changes: After pulling the detailed data from the relevant feeds, compare the newly retrieved data against previously stored data to verify the changes and update your records accordingly.
Update Frequency
TTL / Cache: 300 seconds
Data Updates:
- Entries populate live for changes to teams, players, game statistics, schedules, and standings.
- Start time of the log is 05:00:00 UTC; end time is 04:59:59 UTC
Updated about 2 months ago