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 NCAAMB 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 College Basketball 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 NCAAM 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 NCAAMB league 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 NCAAMB season.
Example - Daily Schedule
{
"date": "2024-11-04",
"league": {
"id": "cd4268ee-07aa-4c4d-a435-ec44ad2c76cb",
"name": "NCAA MEN",
"alias": "NCAAM"
},
"games": [
{
"id": "429eb810-fa68-4f80-8eda-6fd7329cb5d9",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-04T17:00:00Z",
"neutral_site": true,
"conference_game": false,
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "a477ebf3-eb2b-4846-a02b-a60c8ddc831c",
"name": "Sanford Pentagon",
"capacity": 3250,
"address": "2210 W. Pentagon Place",
"city": "Sioux Falls",
"state": "SD",
"zip": "57107",
"country": "USA",
"location": {
"lat": "43.593056",
"lng": "-96.758611"
}
},
"home": {
"name": "Southern Illinois Salukis",
"alias": "SIU",
"id": "7cdfcf92-7fe7-46f1-9b66-6912114182e6"
},
"away": {
"name": "Charleston Cougars",
"alias": "COFC",
"id": "8548dacb-3636-48a8-8c46-611ab0c15fc0"
}
},
{
"id": "92afe7e8-d563-40fd-b9ab-64cc16b7290a",
"status": "scheduled",
"coverage": "full",
"scheduled": "2024-11-04T17:30:00Z",
"conference_game": false,
"time_zones": {
"venue": "US/Central",
"home": "US/Central"
},
"venue": {
"id": "7e440eb5-7e21-4f97-8f88-c39852009991",
"name": "Pete Mathews Coliseum",
"capacity": 5300,
"address": "700 N Pelham Road",
"city": "Jacksonville",
"state": "AL",
"zip": "36265",
"country": "USA",
"location": {
"lat": "33.822",
"lng": "-85.766"
}
},
"home": {
"name": "Jacksonville State Gamecocks",
"alias": "JVST",
"id": "13358462-e05b-4449-8688-90c4622cdde8"
},
"away": {
"name": "LaGrange Panthers",
"alias": "LGRA",
"id": "75dde968-9317-44db-bfc1-50528f525af8"
}
},
{
"id": "27efbe72-1df4-4176-87a5-207942c02479",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-11-04T18:00:00Z",
"conference_game": false,
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "ad56c582-5504-41b6-b7be-fe26d4ceddbf",
"name": "Trojan Arena",
"capacity": 5200,
"address": "5000 Veterans Stadium Drive",
"city": "Troy",
"state": "AL",
"zip": "36082",
"country": "USA",
"location": {
"lat": "31.802222",
"lng": "-85.954722"
}
},
"home": {
"name": "Troy Trojans",
"alias": "TROY",
"id": "6373b18c-62f6-49bc-bd4c-8959a2466516"
},
"away": {
"name": "Toledo Rockets",
"alias": "TOL",
"id": "34dd83ac-64f2-4b73-8577-899b2a46f5cc"
}
},
{
"id": "2d973078-4368-4e2b-976d-6fd9dc7a6fc5",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-11-04T18:00:00Z",
"conference_game": false,
"time_zones": {
"venue": "US/Central",
"home": "US/Central"
},
"venue": {
"id": "ad32e921-33cd-43fd-8057-c50dfd97ccb2",
"name": "Knapp Center",
"capacity": 7152,
"address": "2601 Forest Avenue",
"city": "Des Moines",
"state": "IA",
"zip": "50311",
"country": "USA",
"location": {
"lat": "41.604444",
"lng": "-93.651944"
}
},
"home": {
"name": "Drake Bulldogs",
"alias": "DRKE",
"id": "aed211c3-23a4-4188-ad70-22c6eba7d765"
},
"away": {
"name": "York College (NE) Panthers",
"alias": "YORK",
"id": "34309039-b4f3-4afc-96a3-844ec0e9a150"
}
},
{
"id": "3c37994f-aac9-4beb-8e04-5550b028b189",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-11-04T18:00:00Z",
"conference_game": false,
"time_zones": {
"venue": "US/Pacific",
"home": "US/Pacific",
"away": "US/Central"
},
"venue": {
"id": "d06f9894-d231-44f1-8788-33b28e1dfd3e",
"name": "Lawlor Events Center",
"capacity": 11536,
"address": "1500 N Virginia Street",
"city": "Reno",
"state": "NV",
"zip": "89557",
"country": "USA",
"location": {
"lat": "39.545069",
"lng": "-119.818269"
}
},
"home": {
"name": "Nevada Wolf Pack",
"alias": "NEV",
"id": "62a73b4a-e281-4483-a1f8-f1160a18e456"
},
"away": {
"name": "Sam Houston Bearkats",
"alias": "SHSU",
"id": "67322042-9c40-4dc2-b33a-4754c02ec82a"
}
},
{
"id": "4b955fd3-1408-4500-a0f5-9335cc412c00",
"status": "time-tbd",
"coverage": "extended_boxscore",
"scheduled": "2024-11-04T18:00:00Z",
"conference_game": false,
"time_zones": {
"venue": "US/Central",
"home": "US/Central"
},
"venue": {
"id": "b946ea20-adc7-4c1d-8628-ba1d6ffb4e12",
"name": "F&M Bank Arena",
"capacity": 5500,
"address": "101 Main St",
"city": "Clarksville",
"state": "TN",
"zip": "37040",
"country": "USA",
"location": {
"lat": "36.5294",
"lng": "87.3602"
}
},
"home": {
"name": "Austin Peay Governors",
"alias": "PEAY",
"id": "a0fdb660-a822-4337-b01d-31c4d2c99c8a"
},
"away": {
"name": "Union (TN) Bulldogs",
"alias": "UNIO",
"id": "932bee13-5963-403a-b7cd-25ad963e9a9c"
}
},
{
"id": "55314505-1933-483c-a88e-65754ea397dd",
"status": "time-tbd",
"coverage": "extended_boxscore",
"scheduled": "2024-11-04T18:00:00Z",
"conference_game": false,
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern"
},
"venue": {
"id": "36b26898-679d-49a0-9ba2-257557a3dc53",
"name": "Seabury Center",
"capacity": 2500,
"address": "313 North Main Street",
"city": "Berea",
"state": "KY",
"zip": "40404",
"country": "USA",
"location": {
"lat": "37.574262",
"lng": "-84.290541"
}
},
"home": {
"name": "Eastern Kentucky Colonels",
"alias": "EKY",
"id": "e48e3dd5-721c-4d96-8ff4-790fe2597bfd"
},
"away": {
"name": "Alice Lloyd Eagles",
"alias": "ALC",
"id": "dc9bf155-af55-44db-baff-3621558ac1f7"
}
},
{
"id": "77a1da56-767b-45ca-93b4-662d6f39e4d7",
"status": "time-tbd",
"coverage": "full",
"scheduled": "2024-11-04T18:00:00Z",
"conference_game": false,
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Central"
},
"venue": {
"id": "7657c204-a20b-527a-99cb-dc29218462aa",
"name": "FedExForum",
"capacity": 18119,
"address": "191 Beale Street",
"city": "Memphis",
"state": "TN",
"zip": "38103",
"country": "USA",
"location": {
"lat": "35.138142",
"lng": "-90.050427"
}
},
"home": {
"name": "Memphis Tigers",
"alias": "MEM",
"id": "1551b3a0-6d10-4ffa-8dfa-73b56f004553"
},
"away": {
"name": "Missouri Tigers",
"alias": "MIZZ",
"id": "77ca152a-cb2f-48a5-97b2-492351250d94"
}
}
]
}
This response from the NCAAMB 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, and venues. 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 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 NCAAMB 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 NCAAMB include:
REG: Regular Season
Refers to games that take place during the NCAA regular season.CT: Conference Tournaments
Refers to the conference tournament games that occur after the conclusion of the regular season.PST: Postseason
Refers to the tournaments held at end of the season. These include the Division I March Madness tournament, as well as the NIT, CBI, and CIT tournaments.
- 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
- Conference Tournament (CT): Typically released in early February, as teams are finalized based on standings and conference guidelines.
- Regular Season (REG): Released in the summer, often around July or August, ahead of the fall season start.
- Postseason (PST): Announced on Selection Sunday in mid-March, after the regular season and conference tournaments are complete.
Update Frequency for Schedules
The NCAA Basketball schedule is typically made available two weeks before the season begins once all teams have announced their schedules.. 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_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, and venue. Format this data into a readable structure like a table, list, or calendar.
-
Handle time zones: Use the
time_zonesfield 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 Tennessee Volunteers
This is an example of how you can render a team-specific NCAAMB schedule using data from the schedule API. You can create a dropdown that lets users select a team (e.g., Volunteers), 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 Tennessee Volunteers.
This example shows how you can use the schedule feeds to showcase recent recent/upcoming regular season games. In the image, there's a clear separation between the regular season and national championship games for the Volunteers, with each championship 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 conference tournament (CT) and regular games, filtering the data by team and closed or scheduled games, and displaying key details like date, opponent, and result.
Daily Change Log
The Daily Change Log endpoint allows for efficient tracking of daily changes to the NCAAMB 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 27 days ago