Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

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 season parameter uses the starting year of the season; for example, to retrieve data for the 2024-25 NCAAWB season, you would use 2024 as 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 NCAAW 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 NCAAWB 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 NCAAWB season.
Daily Schedule Example
{
  "date": "2025-01-06",
  "league": {
    "id": "affab7b6-647e-4304-bbe2-1f9d68cd0cea",
    "name": "NCAA WOMEN",
    "alias": "NCAAW"
  },
  "games": [
    {
      "id": "3172abe9-a1e1-40a8-82f7-cf98fde5651e",
      "status": "closed",
      "coverage": "extended_boxscore",
      "scheduled": "2025-01-06T19:00:00Z",
      "home_points": 54,
      "away_points": 94,
      "conference_game": true,
      "time_zones": {
        "venue": "US/Eastern",
        "home": "US/Eastern",
        "away": "US/Eastern"
      },
      "venue": {
        "id": "d6a41efd-92ef-4c0d-8440-a0e4408d713e",
        "name": "Memorial Hall Gym",
        "capacity": 3000,
        "address": "1200 N DuPont Highway",
        "city": "Dover",
        "state": "DE",
        "zip": "19901",
        "country": "USA",
        "location": {
          "lat": "39.1876",
          "lng": "-75.5434"
        }
      },
      "home": {
        "name": "Delaware State Hornets",
        "alias": "DSU",
        "id": "b2b54427-aa1c-4a61-bd37-b0e0eeeffc52"
      },
      "away": {
        "name": "Norfolk State Spartans",
        "alias": "NORF",
        "id": "b5e934ea-6013-48a8-a11b-d63f633f151d"
      }
    },
    {
      "id": "3c8e58a5-e6eb-4608-bff1-73864446ea15",
      "status": "closed",
      "coverage": "extended_boxscore",
      "scheduled": "2025-01-06T22:30:00Z",
      "home_points": 84,
      "away_points": 38,
      "conference_game": true,
      "time_zones": {
        "venue": "US/Eastern",
        "home": "US/Eastern",
        "away": "US/Eastern"
      },
      "venue": {
        "id": "ef2ed392-fb1b-42b7-9895-0a12f908e63e",
        "name": "Physical Education Complex",
        "capacity": 4100,
        "address": "2500 W North Avenue",
        "city": "Baltimore",
        "state": "MD",
        "zip": "21216",
        "country": "USA",
        "location": {
          "lat": "39.3156591",
          "lng": "-76.6568654"
        }
      },
      "home": {
        "name": "Coppin State Eagles",
        "alias": "COPP",
        "id": "1f42b2b7-24dc-4944-bf09-046797576b9e"
      },
      "away": {
        "name": "South Carolina State Lady Bulldogs",
        "alias": "SCST",
        "id": "f8eb4678-84b5-4871-bc3f-567f4484129a"
      }
    }
  ]
}

This response from the NCAAWB Daily Schedule endpoint gives you a detailed list of games scheduled for January 6, 2025. 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.


Loading Schedule Data

  1. Determine the correct season value: The season parameter corresponds to the starting year of the season. For example, to retrieve data for the 2024–25 NCAAWB season, use 2024 as the season value. To check the most current season available, refer to the Seasons feed.
  2. Use the correct season type code for the data you want. Available season types for NCAAWB include:
    1. REG: Regular Season
      Refers to games that take place during the NCAA regular season.
    2. CT: Conference Tournaments
      Refers to the conference tournament games that occur after the conclusion of the regular season.
    3. PST: Postseason
      Refers to the tournaments held at end of the season. These include the Division I March Madness tournament, and the WNIT.
  3. Set your calls based on the update frequency of the schedule feeds:
    1. Schedule feeds have a TTL/Cache of 10 seconds.
    2. 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.
    3. Schedule information is updated in realtime as changes are made.
  4. 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:

  1. 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.

  2. 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.

  3. Sort the games chronologically: After filtering for the team, you can sort the games by date and time (scheduled field) to ensure the schedule is displayed in the correct order.

  4. 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.

  5. Handle time zones: Use the time_zones field 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 NCAAWB 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.

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 NCAAWB 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.