Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Find all updates to the NCAA Men's Basketball v4 API and its documentation

Added Language Translations

Release DateFeeds AffectedBenefit
06/11/2024All feeds with teams, players,
and play-by-play descriptions.
We added language translations for all feeds with teams, players, and play-by-play descriptions.

The following languages are now available:

- Brazilian Portuguese
- English
- French
- Russian
- Simplified Chinese
- Spanish

TBD vs. TBD Support

Release DateFeeds AffectedBenefit
04/11/2024Daily Schedule

Schedule

Tournament Schedule
We are introducing support for Team TBD as a placeholder team.

This means you will now be able to obtain scheduled future games with known dates, even when one or both participants are yet to be determined.

See below for sample data.
<league xmlns="http://feed.elasticstats.com/schema/basketball/schedule-v5.0.xsd" id="4353138d-4c22-4396-95d8-5f587d2df25c" name="NBA" alias="NBA">
    <season-schedule id="851f97e4-c830-4590-88e9-e1286383148c" year="2023" type="PIT">
        <series id="4d8021ed-288b-4585-ad97-f82e6bc1ddf5" title="Eastern Conference - Play-in Round - #10 vs #9" round="1" start_date="2024-04-17" status="scheduled">
            <games>
                <game id="adafa13c-68d5-4127-bad0-48f46dc3485d" status="time-tbd" coverage="full" scheduled="2024-04-17T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          </home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          </away>
                </game>
            </games>
        </series>
        <series id="6171e123-afe8-4c67-b198-a33a29e7a572" title="Western Conference - Play-in Round - #8 vs #7" round="1" start_date="2024-04-16" status="scheduled">
            <games>
                <game id="34fbb07b-8985-45e8-b0e0-00a717230b90" status="time-tbd" coverage="full" scheduled="2024-04-16T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
        <series id="6f9c0c8d-0cc2-4c14-bc8c-5b0de7942b1a" title="Western Conference - Play-in Round - TBD vs TBD" round="1" start_date="2024-04-19" status="scheduled">
            <participant name="Western Conference - Play-in Round - #8 vs #7" record="0">
                <source id="6171e123-afe8-4c67-b198-a33a29e7a572" title="Western Conference - Play-in Round - #8 vs #7" round="1" outcome="loss"/>
            </participant>
            <participant name="Western Conference - Play-in Round - #10 vs #9" record="0">
                <source id="bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8" title="Western Conference - Play-in Round - #10 vs #9" round="1" outcome="win"/>
            </participant>
            <games>
                <game id="75da7f44-61fd-4590-b97a-074d863b20a7" status="time-tbd" coverage="full" scheduled="2024-04-19T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
        <series id="bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8" title="Western Conference - Play-in Round - #10 vs #9" round="1" start_date="2024-04-17" status="scheduled">
            <games>
                <game id="658de491-08be-4279-a8a7-6f98f1637e70" status="time-tbd" coverage="full" scheduled="2024-04-17T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
        <series id="ca09ddfd-fe0c-4914-8847-da15e23d251b" title="Eastern Conference - Play-in Round - #8 vs #7" round="1" start_date="2024-04-16" status="scheduled">
            <games>
                <game id="bd80d85f-28e4-4ae9-8dea-97b14951e8c2" status="time-tbd" coverage="full" scheduled="2024-04-16T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
        <series id="ec633fa3-3c1c-4560-98ac-5f75850d70e1" title="Eastern Conference - Play-in Round - TBD vs TBD" round="1" start_date="2024-04-19" status="scheduled">
            <participant name="Eastern Conference - Play-in Round - #8 vs #7" record="0">
                <source id="ca09ddfd-fe0c-4914-8847-da15e23d251b" title="Eastern Conference - Play-in Round - #8 vs #7" round="1" outcome="loss"/>
            </participant>
            <participant name="Eastern Conference - Play-in Round - #10 vs #9" record="0">
                <source id="4d8021ed-288b-4585-ad97-f82e6bc1ddf5" title="Eastern Conference - Play-in Round - #10 vs #9" round="1" outcome="win"/>
            </participant>
            <games>
                <game id="b1c9bbbe-feb8-43e8-8226-4df5f013c0ff" status="time-tbd" coverage="full" scheduled="2024-04-19T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
    </season-schedule>
</league>


{
    "league": {
        "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
        "name": "NBA",
        "alias": "NBA"
    },
    "season": {
        "id": "851f97e4-c830-4590-88e9-e1286383148c",
        "year": 2023,
        "type": "PIT"
    },
    "series": [
        {
            "id": "4d8021ed-288b-4585-ad97-f82e6bc1ddf5",
            "title": "Eastern Conference - Play-in Round - #10 vs #9",
            "round": 1,
            "start_date": "2024-04-17",
            "status": "scheduled",
            "participants": [],
            "games": [
                {
                    "id": "adafa13c-68d5-4127-bad0-48f46dc3485d",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-17T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "6171e123-afe8-4c67-b198-a33a29e7a572",
            "title": "Western Conference - Play-in Round - #8 vs #7",
            "round": 1,
            "start_date": "2024-04-16",
            "status": "scheduled",
            "participants": [],
            "games": [
                {
                    "id": "34fbb07b-8985-45e8-b0e0-00a717230b90",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-16T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "6f9c0c8d-0cc2-4c14-bc8c-5b0de7942b1a",
            "title": "Western Conference - Play-in Round - TBD vs TBD",
            "round": 1,
            "start_date": "2024-04-19",
            "status": "scheduled",
            "participants": [
                {
                    "name": "Western Conference - Play-in Round - #8 vs #7",
                    "record": 0,
                    "source": {
                        "id": "6171e123-afe8-4c67-b198-a33a29e7a572",
                        "title": "Western Conference - Play-in Round - #8 vs #7",
                        "round": 1,
                        "outcome": "loss"
                    }
                },
                {
                    "name": "Western Conference - Play-in Round - #10 vs #9",
                    "record": 0,
                    "source": {
                        "id": "bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8",
                        "title": "Western Conference - Play-in Round - #10 vs #9",
                        "round": 1,
                        "outcome": "win"
                    }
                }
            ],
            "games": [
                {
                    "id": "75da7f44-61fd-4590-b97a-074d863b20a7",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-19T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8",
            "title": "Western Conference - Play-in Round - #10 vs #9",
            "round": 1,
            "start_date": "2024-04-17",
            "status": "scheduled",
            "participants": [],
            "games": [
                {
                    "id": "658de491-08be-4279-a8a7-6f98f1637e70",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-17T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "ca09ddfd-fe0c-4914-8847-da15e23d251b",
            "title": "Eastern Conference - Play-in Round - #8 vs #7",
            "round": 1,
            "start_date": "2024-04-16",
            "status": "scheduled",
            "participants": [],
            "games": [
                {
                    "id": "bd80d85f-28e4-4ae9-8dea-97b14951e8c2",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-16T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "ec633fa3-3c1c-4560-98ac-5f75850d70e1",
            "title": "Eastern Conference - Play-in Round - TBD vs TBD",
            "round": 1,
            "start_date": "2024-04-19",
            "status": "scheduled",
            "participants": [
                {
                    "name": "Eastern Conference - Play-in Round - #8 vs #7",
                    "record": 0,
                    "source": {
                        "id": "ca09ddfd-fe0c-4914-8847-da15e23d251b",
                        "title": "Eastern Conference - Play-in Round - #8 vs #7",
                        "round": 1,
                        "outcome": "loss"
                    }
                },
                {
                    "name": "Eastern Conference - Play-in Round - #10 vs #9",
                    "record": 0,
                    "source": {
                        "id": "4d8021ed-288b-4585-ad97-f82e6bc1ddf5",
                        "title": "Eastern Conference - Play-in Round - #10 vs #9",
                        "round": 1,
                        "outcome": "win"
                    }
                }
            ],
            "games": [
                {
                    "id": "b1c9bbbe-feb8-43e8-8226-4df5f013c0ff",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-19T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        }
    ]
}


Standings Data

Release DateFeeds
Affected
Benefit
02/27/2024StandingsAdded the below data attributes to the Standings endpoint:

- Conference Points For (conf_points_for)

- Conference Points Against (conf_points_against)
- Clinched (clinched)
- Post Season Ineligible (post_season_ineligible)
- Strength of Schedule Rank (strength_of_schedule_rank)
- Conference Rank (conference_rank)
- Subdivision Rank (subdivision_rank)
{
"id": "9ed9d01e-977c-4ba7-ac7d-64035039461c",
"name": "Southeastern",
"alias": "SEC",
"teams": [
{
    "id": "b827dbdf-230f-4916-9703-3bb9004e26eb",
    "name": "Volunteers",
    "market": "Tennessee",
    "wins": 21,
    "losses": 6,
    "win_pct": 0.778,
    "points_for": 80.26,
    "points_against": 66.56,
    "point_diff": 13.7,
    "conf_points_for": 82.5,
    "conf_points_against": 68.64,
    "clinched": null,
    "post_season_ineligible": false,
    "strength_of_schedule_rank": 2,
    "conference_rank": 1,
    "subdivision_rank": 0,
    "games_behind": {
        "conference": 0.0
    },
    "streak": {
        "kind": "win",
        "length": 4
    },
    "records": [
        {
            "record_type": "a10",
            "wins": 1,
            "losses": 0,
            "win_pct": 1.0
        },
        {
            "record_type": "acc",
            "wins": 2,
            "losses": 1,
            "win_pct": 0.667
        },
        {
            "record_type": "below_500",
            "wins": 4,
            "losses": 0,
            "win_pct": 1.0
        },
        {
            "record_type": "big10",
            "wins": 2,
            "losses": 1,
            "win_pct": 0.667
        },
        {
            "record_type": "big12",
            "wins": 0,
            "losses": 1,
            "win_pct": 0.0
        },
        {
            "record_type": "conference",
            "wins": 11,
            "losses": 3,
            "win_pct": 0.786
        },
        {
            "record_type": "equal_rebounds",
            "wins": 1,
            "losses": 1,
            "win_pct": 0.5
        },
        {
            "record_type": "equal_turnovers",
            "wins": 4,
            "losses": 0,
            "win_pct": 1.0
        },
        {
            "record_type": "fewer_turnovers",
            "wins": 11,
            "losses": 5,
            "win_pct": 0.688
        },
        {
            "record_type": "home",
            "wins": 13,
            "losses": 1,
            "win_pct": 0.929
        },
        {
            "record_type": "last_10",
            "wins": 8,
            "losses": 2,
            "win_pct": 0.8
        },
        {
            "record_type": "last_10_home",
            "wins": 9,
            "losses": 1,
            "win_pct": 0.9
        },
        {
            "record_type": "last_10_road",
            "wins": 6,
            "losses": 4,
            "win_pct": 0.6
        },
        {
            "record_type": "leads_field_goal_pct",
            "wins": 20,
            "losses": 2,
            "win_pct": 0.909
        },
        {
            "record_type": "leads_rebounds",
            "wins": 18,
            "losses": 0,
            "win_pct": 1.0
        },
        {
            "record_type": "meac",
            "wins": 1,
            "losses": 0,
            "win_pct": 1.0
        },
        {
            "record_type": "neutral",
            "wins": 2,
            "losses": 2,
            "win_pct": 0.5
        },
        {
            "record_type": "opponent_fewer_turnovers",
            "wins": 6,
            "losses": 1,
            "win_pct": 0.857
        },
        {
            "record_type": "opponent_leads_field_goal_pct",
            "wins": 1,
            "losses": 4,
            "win_pct": 0.2
        },
        {
            "record_type": "opponent_leads_rebounds",
            "wins": 2,
            "losses": 5,
            "win_pct": 0.286
        },
        {
            "record_type": "opponent_scores_100_or_more",
            "wins": 0,
            "losses": 1,
            "win_pct": 0.0
        },
        {
            "record_type": "ovc",
            "wins": 1,
            "losses": 0,
            "win_pct": 1.0
        },
        {
            "record_type": "overtime",
            "wins": 0,
            "losses": 0,
            "win_pct": 0.0
        },
        {
            "record_type": "over_500",
            "wins": 17,
            "losses": 6,
            "win_pct": 0.739
        },
        {
            "record_type": "road",
            "wins": 6,
            "losses": 3,
            "win_pct": 0.667
        },
        {
            "record_type": "scores_100_or_more",
            "wins": 1,
            "losses": 0,
            "win_pct": 1.0
        },
        {
            "record_type": "sec",
            "wins": 11,
            "losses": 3,
            "win_pct": 0.786
        },
        {
            "record_type": "southern",
            "wins": 1,
            "losses": 0,
            "win_pct": 1.0
        },
        {
            "record_type": "sunbelt",
            "wins": 1,
            "losses": 0,
            "win_pct": 1.0
        },
        {
            "record_type": "ten_points",
            "wins": 17,
            "losses": 1,
            "win_pct": 0.944
        },
        {
            "record_type": "three_points",
            "wins": 0,
            "losses": 0,
            "win_pct": 0.0
        },
        {
            "record_type": "top_25",
            "wins": 3,
            "losses": 3,
            "win_pct": 0.5
        },
        {
            "record_type": "wac",
            "wins": 1,
            "losses": 0,
            "win_pct": 1.0
        }
    ]
},
<team id="c10544de-e3bd-4776-ba2e-83df8c017fd1" name="Hawkeyes" market="Iowa" 
      wins="16" losses="12" win_pct="0.571" points_for="83.5" points_against="78.68" 
      point_diff="4.82" conf_points_for="79.06" conf_points_against="80.94" 
      post_season_ineligible="false" strength_of_schedule_rank="9" conference_rank="9" 
      subdivision_rank="0">
    <games-behind conference="6.0"/>
    <streak>
        <loss length="1"/>
    </streak>
    <records>
        <record record_type="ae" wins="1" losses="0" win_pct="1.0"/>
        <record record_type="as" wins="1" losses="0" win_pct="1.0"/>
        <record record_type="below_500" wins="5" losses="1" win_pct="0.833"/>
        <record record_type="big10" wins="8" losses="9" win_pct="0.471"/>
        <record record_type="big12" wins="0" losses="2" win_pct="0.0"/>
        <record record_type="bigeast" wins="1" losses="1" win_pct="0.5"/>
        <record record_type="conference" wins="8" losses="9" win_pct="0.471"/>
        <record record_type="equal_turnovers" wins="1" losses="2" win_pct="0.333"/>
        <record record_type="fewer_turnovers" wins="12" losses="5" win_pct="0.706"/>
        <record record_type="home" wins="11" losses="3" win_pct="0.786"/>
        <record record_type="last_10" wins="5" losses="5" win_pct="0.5"/>
        <record record_type="last_10_home" wins="8" losses="2" win_pct="0.8"/>
        <record record_type="last_10_road" wins="3" losses="7" win_pct="0.3"/>
        <record record_type="leads_field_goal_pct" wins="16" losses="2" win_pct="0.889"/>
        <record record_type="leads_rebounds" wins="11" losses="3" win_pct="0.786"/>
        <record record_type="mac" wins="1" losses="0" win_pct="1.0"/>
        <record record_type="neutral" wins="2" losses="1" win_pct="0.667"/>
        <record record_type="opponent_fewer_turnovers" wins="3" losses="5" win_pct="0.375"/>
        <record record_type="opponent_leads_field_goal_pct" wins="0" losses="10" win_pct="0.0"/>
        <record record_type="opponent_leads_rebounds" wins="5" losses="9" win_pct="0.357"/>
        <record record_type="over_500" wins="11" losses="11" win_pct="0.5"/>
        <record record_type="overtime" wins="1" losses="0" win_pct="1.0"/>
        <record record_type="road" wins="3" losses="8" win_pct="0.273"/>
        <record record_type="scores_100_or_more" wins="4" losses="0" win_pct="1.0"/>
        <record record_type="summit" wins="1" losses="0" win_pct="1.0"/>
        <record record_type="sunbelt" wins="1" losses="0" win_pct="1.0"/>
        <record record_type="swac" wins="2" losses="0" win_pct="1.0"/>
        <record record_type="ten_points" wins="10" losses="9" win_pct="0.526"/>
        <record record_type="three_points" wins="2" losses="1" win_pct="0.667"/>
        <record record_type="top_25" wins="1" losses="5" win_pct="0.167"/>
    </records>
</team>


Player Preseason Stats

Release DateFeeds AffectedBenefit
02/08/2024Player ProfileAdded preseason and postseason statistics to player profiles.


Player Status

Release DateFeeds
Affected
Benefit
01/03/2024Player Profile

Team Profile
Added DUP (Duplicate) as a valid player status.

Players marked as status="DUP" can be ignored in the data.

New Shot Type Descriptions

Release DateFeeds AffectedBenefit
11/10/2022Play-by-PlayAdded several new shot type descriptions (shot_type_desc) for all games in the Play-by-Play endpoint. For a complete list of the new descriptions please see our FAQs.

Removed Player Data

Release DateFeeds AffectedBenefit
08/12/2020Player Profile
Team Profile
Removed the high_school and birth_date data points.

Removed Hierarchy Data

Release DateFeeds AffectedBenefit
01/31/2019League Hierarchy
Standings
Removed team – subdivision from the League Hierarchy feed and corrected the location of the data point to the Standings feed. Added a note that it currently is only available in the json format of the feed.

New Push Data

Release DateFeeds AffectedBenefit
04/24/2018Push EventsAdded the following data points to the Push Events feed: event – away_points, event – home_points, qualifiers – qualifier, event – sequence, and event – wall_clock.

Player Seasonal Statistics

Release DateFeeds AffectedBenefit
02/13/2018League LeadersAdded Player Seasonal Statistics to the League Leaders feed.

New Push Feeds

Release DateFeeds AffectedBenefit
11/20/2018Push Events
Push Statistics
Added all data points for Push Events and Push Statistics.

API Release

Release DateFeeds AffectedBenefit
11/07/2017AllInitial release for NCAA Men's Basketball v4.