Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

NCAAFB FAQs

Frequently asked questions for NCAA Football v7

Click on the categories below or browse questions on the right panel.

Categories

.


Coverage


How is each NCAA Football game covered?

Coverage information for NCAA Men's Football can be found here.


What are the possible values for game coverage levels?

The valid coverage levels are:

  • full
  • extended_boxscore


Integration


How can I get started with my integration?

Set up an account, learn the NCAA Football API basics, study our game workflows, tackle in-depth integration scenarios, and more by visiting our NCAAFB v7 Integration Guide!


Are simulations available for this API?

Yes! You can replay past games as though they were live using our on-demand Simulations service.


What format are date fields presented in?

When we present date only values we present these in the ISO 8601 standard format.

ex: 2013-04-03

We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601


What format are the date/time fields presented in?

All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.

ex: 2013-04-03T18:15:00+00:00

For more information: https://en.wikipedia.org/wiki/ISO_8601


How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or
cache-control: public, must-revalidate, max-age=120



Game Statuses & Types


What are the game statuses and their descriptions?

Here are the valid game statuses and their descriptions:

  • scheduled – The game is scheduled to occur.
  • created – Game data (rosters, officials, etc) are being pre-loaded in preparation for the game.
  • inprogress – The game is in progress.
  • halftime – The game is currently at halftime.
  • complete – The game is over, but stat validation is not complete.
  • closed – The game is over and the stats have been validated.
  • cancelled – The game has been cancelled. No makeup game will be played as a result.
  • postponed – The game has been postponed, to be made up at another day and time. Once the makeup game is announced, a new game and ID will be created and scheduled on the announced makeup date. You should request the scheduled feed(s) regularly to identify the re-scheduled makeup game(s).
  • delayed – The scheduled game, or a game that was in progress, is now delayed for some reason.
  • suspended – The game has been suspended and will be rescheduled in the future, continuing where they left off. The game ID will remain the same.
  • flex-schedule – The game is currently scheduled to occur on a specific date and time, however, it will more than likely be moved to a different time for broadcast purposes.
  • time-tbd – The game has been scheduled, but a time has yet to be announced.

What are the valid game types and their definitions?

Here are the valid game types and their descriptions:

  • regular – This is a regular season game.
  • bowl – This is a bowl game (FBS postseason game).
  • playoff – This is a playoff game.
  • conference_championship – This is the conference championship game.

What are the valid playoff game types?

Here are the valid playoff game types:

  • CFP First Round
  • CFP Quaterfinal
  • CFP Semifinal
  • CFP National Championship
  • FCS First Round
  • FCS Second Round
  • FCS Quarterfinal
  • FCS Semifinal
  • FCS Championship


Data Workflow

How can I find timings for data entry updates?

Our NCAA Football Data Entry Workflow section covers data availability updates. This includes updates for coverage levels, schedules, rankings, stat validation, and more.



Season Types


What are the valid season types?

The only valid season for NCAAFB is REG.

All FBS bowl and FCS playoff games appear in the specific week number of the game. As games are announced, an additional week is added to the schedule which includes all scheduled games.

Example (Week 19):

Weekly Schedule: api.sportradar.com/ncaafb/trial/v7/en/games/2022/REG/19/schedule.xml?api_key=<API_KEY>

<season xmlns="http://feed.elasticstats.com/schema/football/schedule-v7.0.xsd" id="ff53e5e4-10ef-4842-a0b7-b489956fa07e" year="2022" type="REG" name="REG">
    <week id="c5b272b0-388f-496d-ab6f-0a341b0a116b" sequence="19" title="19">
        <game id="4ebf12b3-f275-48a7-992f-8c56f0d1d177" status="closed" scheduled="2023-01-08T19:00:00+00:00" attendance="18023" entry_mode="LDE" coverage="full" playoff_game_type="FCS Championship" sr_id="sr:match:38107137" neutral_site="true" game_type="playoff" conference_game="false" title="NCAA Division I Football Championship" duration="3:07">
            <venue id="b6d40461-52a0-4994-b182-8b567a90eb0b" name="Toyota Stadium" city="Frisco" state="TX" country="USA" zip="75033" address="9200 World Cup Way" capacity="20500" surface="turf" roof_type="outdoor">
      </venue>
            <home id="47e6bd48-6207-4316-9b89-f1cfef889746" name="South Dakota State Jackrabbits" alias="SDS" game_number="15"/>
            <away id="0a05210a-81f7-4d04-80e5-4ba6ee748ccd" name="North Dakota State Bison" alias="NDS" game_number="15"/>
            <broadcast network="ABC"/>
            <weather condition="Sunny" humidity="40" temp="56">
                <wind speed="6" direction="NNE"/>
            </weather>
            <scoring home_points="45" away_points="21">
                <quarter id="12f98a79-f6fc-491c-92eb-819ece873719" number="1" sequence="1" home_points="7" away_points="7"/>
                <quarter id="d7d8f5e8-b154-411e-858e-11c28c4c406a" number="2" sequence="2" home_points="24" away_points="7"/>
                <quarter id="534bc3f0-da4b-48fb-a8ec-096e52692f0f" number="3" sequence="3" home_points="7" away_points="0"/>
                <quarter id="8bc88f90-e8f1-4cb7-924c-133b723e0500" number="4" sequence="4" home_points="7" away_points="7"/>
            </scoring>
        </game>
        <game id="c9686716-f48a-4667-996d-97639429d8c3" status="closed" scheduled="2023-01-10T00:30:00+00:00" attendance="72628" entry_mode="LDE" coverage="full" playoff_game_type="CFP National Championship" sr_id="sr:match:38354639" neutral_site="true" game_type="playoff" conference_game="false" title="CFP National Championship" duration="3:11">
            <venue id="d451edc0-560f-11ec-aa5b-21e3f11e4eb0" name="SoFi Stadium" city="Inglewood" state="CA" country="USA" zip="90301" address="1001 Stadium Drive" capacity="70240" surface="artificial" roof_type="dome">
      </venue>
            <home id="2eef738d-c637-4b12-b8df-4b79efcce71e" name="Georgia Bulldogs" alias="UGA" game_number="15"/>
            <away id="a09e634d-39a8-4aa8-81a4-7337580a31f4" name="TCU Horned Frogs" alias="TCU" game_number="15"/>
            <broadcast network="ESPN" satellite="206"/>
            <weather condition="Overcast" humidity="83" temp="61">
                <wind speed="15" direction="SE"/>
            </weather>
            <scoring home_points="65" away_points="7">
                <quarter id="73159676-8398-4209-bde3-79e33d1a65b8" number="1" sequence="1" home_points="17" away_points="7"/>
                <quarter id="11e983e2-7032-4dcc-9b1c-8dbf64f0c39a" number="2" sequence="2" home_points="21" away_points="0"/>
                <quarter id="287df9e6-8013-4762-8900-9a4e582de9fb" number="3" sequence="3" home_points="14" away_points="0"/>
                <quarter id="7bae8da2-7167-4c61-9f70-fc1003210a3b" number="4" sequence="4" home_points="13" away_points="0"/>
            </scoring>
        </game>
        <bye_week>
            <team id="00cbe6eb-c9c2-43d4-8158-6952066f0d2b" name="Tribe" alias="WM"/>
            <team id="00fd8418-0e62-4366-9a2a-d5f72850066c" name="Sun Devils" alias="ASU"/>
            <team id="018e079b-3848-49bf-8fc6-2d44bbc120a0" name="Hatters" alias="STU"/>
            <team id="02cd61b6-2dad-4b3d-94cd-1c1c3cdbf3ad" name="Lobos" alias="NM"/>
            <team id="034ac81a-311c-49f4-8c45-ddcef7777bdc" name="Wolfpack" alias="NCST"/>
            <team id="03aa49b8-9a36-4e77-adf1-01cc5e2e6a14" name="Chippewas" alias="CMC"/>
            <team id="04f8c610-fe83-4b44-a3fc-02394869b81f" name="Rams" alias="CSU"/>
            <team id="05639ea0-a3e6-4d56-b257-366545b0ff4d" name="Spiders" alias="RCH"/>
            <team id="073da9d4-85ed-4d25-8834-c71e573838b2" name="Golden Lions" alias="APB"/>
            <team id="0767c157-b084-4239-a684-954a22671bce" name="Huskies" alias="NIL"/>
            <team id="0a2ac5e2-3a44-4ced-ac1e-5089fcbacf92" name="Coyotes" alias="SD"/>
            <team id="0b1cdc10-d570-431a-90f1-c629130e9d5b" name="Knights" alias="STAW"/>
            <team id="0c59b9f5-6261-4aec-a491-d5a6a53f3e50" name="Braves" alias="ALCST"/>
            <team id="0c8fc8f1-0659-49dd-8668-436c3812089e" name="Wolf Pack" alias="NEV"/>
            <team id="0cbc0bb6-596a-49da-a1cb-bfa42b5fcb56" name="Huskies" alias="HB"/>
            <team id="0d04c99b-4ff5-4cec-a172-e579a1f8f54a" name="Mocs" alias="CHT"/>
            <team id="0dd26ea7-79fb-4ea8-bf48-7c31108e14a3" name="Wildcats" alias="KST"/>
            <team id="0e06bfbe-01ef-414d-a6a7-53432f547586" name="Bulldogs" alias="BUT"/>
            <team id="0fdbf00d-49c6-4c31-abb1-b40cab08c40e" name="Eagles" alias="EMC"/>
            <team id="0fe698d9-b78e-4da5-bc92-c45d84671082" name="Seawolves" alias="SBK"/>
            <team id="15828630-7d0d-4ac5-8707-915879a90943" name="Aggies" alias="UCD"/>
            <team id="158b2ba8-ca8f-429e-b2e1-053ada5bf469" name="Wildcats" alias="NH"/>
            <team id="184584ac-2cee-4c66-b207-552fe3dc94ab" name="Rattlers" alias="FAMU"/>
            <team id="19775492-f1eb-4bc5-9e15-078ebd689c0f" name="Crimson Tide" alias="BAMA"/>
            <team id="1a11c84d-18be-40d0-a354-f188958e16b1" name="Huskies" alias="UCONN"/>
            <team id="1c792ab1-d640-48f2-b796-6a81c7b14eaf" name="Seminoles" alias="FSU"/>
            <team id="1cdf66a2-f157-4b4f-ad37-bd31e268f0ae" name="Spartans" alias="MSU"/>
            <team id="1d1a6543-c77e-4f57-b215-cdaf0e45b0e2" name="Knights" alias="KCU"/>
            <team id="1e1e3a19-cb5a-48a6-b961-a5359d21812d" name="Miners" alias="TEP"/>
            <team id="1e3f5ade-a73e-44d5-a042-0a32f291d6f4" name="Vikings" alias="PRST"/>
            <team id="1e8edb90-ea5e-4663-9a65-a30e51583711" name="Cardinals" alias="LOU"/>
            <team id="1ec48c6a-638f-4a79-a134-ec43bd506612" name="Eagles" alias="GSO"/>
            <team id="1ff5428d-2e8c-4b0f-a5a6-ebff126111a2" name="Cougars" alias="WST"/>
            <team id="20827bfd-4930-4921-8273-1802423e2be7" name="Eagles" alias="BC"/>
            <team id="22083fa4-8d9c-4ccc-8c33-cda772954099" name="Red Raiders" alias="TT"/>
            <team id="23efdc8b-f31b-4827-bc04-15cdd9edbe78" name="Saints" alias="LIC"/>
            <team id="24215f91-06e7-4d28-addf-10e499c15db2" name="Sycamores" alias="INDS"/>
            <team id="242f21d8-7372-4359-a04f-4d467ead22d6" name="Sooners" alias="OKL"/>
            <team id="2516eb07-9a48-436c-b8ee-c14eae88a310" name="Leathernecks" alias="WIL"/>
            <team id="25a0e60a-2452-494b-8d9e-5177962cf569" name="RedHawks" alias="MOH"/>
            <team id="26878834-0b83-4589-b98f-815362ecd48e" name="Huskies" alias="BLOOM"/>
            <team id="273a5eb0-d148-11ec-8af1-3598bba809d8" name="Bobcats" alias="STFL"/>
            <team id="28e1dbb0-1295-42ca-bda1-fddb122aed2b" name="Utes" alias="UTH"/>
            <team id="28f2ce75-b0ca-4cd3-a313-379168b0da95" name="Eagles" alias="MOR"/>
            <team id="297459ac-a24e-4523-a17b-0ec761d4601b" name="Choctaws" alias="MIC"/>
            <team id="29a01b87-f6c2-487b-a0ad-4d6d2d72f16f" name="Cardinals" alias="WJC"/>
            <team id="2a828de7-53d6-4a35-9f55-9aaa226956ed" name="Mean Green" alias="NTX"/>
            <team id="2c40eb6f-f0ac-4d48-b47c-449efb705e6a" name="Buccaneers" alias="CCH"/>
            <team id="2d2b2690-4c17-4acb-ae39-044b36f14758" name="Delta Devils" alias="MVS"/>
            <team id="2d824a5f-e706-45b8-9d20-434ed5dd5c2f" name="Fighting Illini" alias="ILL"/>
            <team id="2dec939a-f303-43ac-964d-37e81f75e286" name="Ragin' Cajuns" alias="ULL"/>
            <team id="2e13191e-eb51-4d25-a3c7-7dec1fbfd3c8" name="Lions" alias="LU"/>
            <team id="2ed1462d-6670-4094-a86d-d723ae3b1886" name="Royals" alias="WAR"/>
            <team id="2f475a40-df87-43a7-b8a9-c36a43edff21" name="Hurricanes" alias="MFL"/>
            <team id="2f75b2cd-5c06-4c39-a191-251c9a47376b" name="Wildcats" alias="VIL"/>
            <team id="2ffd2c8c-9100-46d1-8d33-6e154b0527fc" name="Lions" alias="SEL"/>
            <team id="30919b0c-7316-414f-a393-7151252438cb" name="Crimson" alias="HAR"/>
            <team id="30abfee7-57a7-4984-9a1c-55cb28970da3" name="49ers" alias="CHA"/>
            <team id="31303230-d14a-11ec-8af1-3598bba809d8" name="Cardinals" alias="CCMI"/>
            <team id="31cc5b49-fbc5-4aca-9196-fbcce6bc6ad9" name="Owls" alias="RICE"/>
            <team id="3522e1d5-7dc6-4586-a14f-276f56e0c60e" name="Bison" alias="BUC"/>
            <team id="35aa5295-ad07-4b95-aad2-63d1d5bf9009" name="Broncos" alias="BOISE"/>
            <team id="36680161-4534-4723-bc72-84066a84ffe9" name="Tommies" alias="UST"/>
            <team id="3797e777-4e75-413f-9866-f9f9ded35a8f" name="Maroon Tigers" alias="MRHC"/>
            <team id="38157fcd-b2d8-4ecf-ad50-272f8228bf34" name="Cougars" alias="HOU"/>
            <team id="397830a6-c9c2-4c76-bcbc-cb1cdba768f0" name="Falcons" alias="BGN"/>
            <team id="398eda2b-ba77-469f-94df-18fd1d9087d8" name="Bruins" alias="UCLA"/>
            <team id="3a4f3861-0fb8-42e0-93b5-8fd41fa82192" name="Racers" alias="MUR"/>
            <team id="3c2c21d3-4a85-4460-bed7-2b49590e66a9" name="Bearcats" alias="MCKU"/>
            <team id="3d32a14a-55e7-429a-9f6f-39aac5955191" name="Demons" alias="NWS"/>
            <team id="3d924b68-94e8-497d-bcbb-37eef4ff911f" name="Colonels" alias="EKY"/>
            <team id="3ed1a496-46af-4c0e-be37-c76ee352d702" name="Demon Deacons" alias="WF"/>
            <team id="3ed71f8c-b9ac-4984-955b-4284b0430cd2" name="Blue Devils" alias="CCSU"/>
            <team id="3ef463a9-30ac-42a6-ab8c-ce34fb66ca79" name="Salukis" alias="SIL"/>
            <team id="3faf7dcc-91ed-4398-86ba-80122955315b" name="Toreros" alias="SDG"/>
            <team id="414c082c-c3b2-467f-b37d-0f08804a0f60" name="Eagles" alias="EW"/>
            <team id="42a9a18b-b59a-408b-8cab-4e49cbe2c23a" name="Bearcats" alias="CIN"/>
            <team id="42f93ad6-d650-4f44-9871-39d40945ad68" name="Stallions" alias="NOAU"/>
            <team id="4318b2b7-0b61-4509-b776-001b08c09dcc" name="Flames" alias="LIB"/>
            <team id="43838b74-5606-4a4c-b8bb-9e6072e45031" name="Bulldogs" alias="BRY"/>
            <team id="44c0deff-f542-4afe-a5c7-43df3bd51d5b" name="Quakers" alias="PEN"/>
            <team id="46188043-b51d-41f5-9e76-b72ee3263ccc" name="Terriers" alias="WOF"/>
            <team id="465236db-280e-49a6-9575-feb4ca20b9b4" name="Grizzlies" alias="MONT"/>
            <team id="485dd62f-108c-4e32-b171-27f5d493552d" name="Boilermakers" alias="PUR"/>
            <team id="4b7ab0a0-c1e3-4a58-b679-77353e70a5eb" name="Bulldogs" alias="DRA"/>
            <team id="4eb165ff-ebe8-4a9e-8a57-34ec90f112e4" name="Redhawks" alias="SEM"/>
            <team id="4f776283-3758-4325-b633-31a5be257a80" name="Panthers" alias="GST"/>
            <team id="50767f7e-8543-4b94-b2b7-486ea647b5c1" name="Rams" alias="RIL"/>
            <team id="515e9431-e87d-4d3e-8916-3ecaa0a05034" name="Owls" alias="KENN"/>
            <team id="52b8ad3d-67ba-45dc-ada8-a6a40844c56c" name="Fighting Camels" alias="CAM"/>
            <team id="52dc23de-c6ba-4467-b964-a433658eded2" name="Razorbacks" alias="ARK"/>
            <team id="52f28fe6-2823-4f26-80ce-605a04e624da" name="Lumberjacks" alias="SAU"/>
            <team id="53aaad5a-b81b-490e-b04a-b650156cd1db" name="Knights" alias="UCF"/>
            <team id="54585fd0-90d0-46bd-a018-d033fb2ee767" name="Aztecs" alias="SDSU"/>
            <team id="5490b68d-5834-47d8-bddc-d78005b917f1" name="Warriors" alias="MC"/>
            <team id="558f07ed-85b3-447d-bdd2-9cd98ca3a547" name="Bulldogs" alias="FRE"/>
            <team id="55da9c15-db47-49d1-9a39-78ef11f2051b" name="Pirates" alias="HAMP"/>
            <team id="5649d2fc-1e64-44ac-a0f2-9d96db4769e9" name="Dukes" alias="DUQ"/>
            <team id="56ba7533-3ea8-4ae9-a192-3ea51a7b0b90" name="Bulldogs" alias="AAM"/>
            <team id="5941ffa3-cdd5-459b-ab61-fef120b929b2" name="Wildcats" alias="KEN"/>
            <team id="59d0852a-b283-4829-af63-60553fbafdeb" name="Beacons" alias="VAL"/>
            <team id="5a1b9269-0c98-48cc-9d0a-1692b9f52d0b" name="Wildcats" alias="WBS"/>
            <team id="5a9498fc-bae2-49d2-af1d-e13d07f4e68f" name="Hokies" alias="VT"/>
            <team id="5b0018d4-52d0-4b53-b90c-2c597298a4bb" name="Cardinals" alias="BALL"/>
            <team id="5b790142-1e09-40cd-b06a-4c2e85893698" name="Panthers" alias="UNI"/>
            <team id="5bf6e8b8-2a02-4906-8253-08f967dd3c2c" name="Bulldogs" alias="LT"/>
            <team id="5c218a3b-a013-4037-97b6-603c9502b701" name="Ducks" alias="ORE"/>
            <team id="5ce8eec9-67a2-4993-8897-6faaa4d28f94" name="Black Bears" alias="UMAINE"/>
            <team id="5cecc23b-cb18-49f2-85ef-3717063e9dca" name="Cardinals" alias="IW"/>
            <team id="5f105ef1-4d01-45a5-bfbb-497ee86a8eba" name="Rebels" alias="UNLV"/>
            <team id="5fb529f6-f6b3-4892-a188-9b38addcc9a3" name="Bulls" alias="BUF"/>
            <team id="5ff038e1-6e3b-4cbe-90b8-751f783cd7a9" name="Yellow Jackets" alias="GT"/>
            <team id="619c5384-3660-44ac-b2ad-597ccb3854c7" name="Mustangs" alias="SMU"/>
            <team id="627b2e5c-3ba5-496e-9f9b-1c620247c1b7" name="Cougars" alias="BYU"/>
            <team id="63297e60-1982-11ed-99fe-2fc534480fcf" name="Eagles" alias="FAK"/>
            <team id="6370f943-c638-43f3-8c6b-740e6c4a8999" name="Warhawks" alias="ULM"/>
            <team id="642dacba-ddf7-4a1f-bcc8-72b0e6f74dc4" name="Skyhawks" alias="STHL"/>
            <team id="6489c587-507f-46a1-a3eb-ee9c2eee23f0" name="Chanticleers" alias="CC"/>
            <team id="650f0a5a-9ef7-4098-ac9d-42b3645646c4" name="Crusaders" alias="HC"/>
            <team id="6551124f-312e-49c8-87c4-d1cba14133c7" name="Green Wave" alias="TUL"/>
            <team id="65736666-38a3-4737-9bea-785641533719" name="Thunderbirds" alias="SUT"/>
            <team id="6653b9f3-44c6-4b23-8d15-d32aebdee1f9" name="Bulldogs" alias="MSST"/>
            <team id="67f319bb-fdae-4d0c-81ca-544c08c86f94" name="Thorobreds" alias="KYSU"/>
            <team id="6923fb41-a948-466b-becf-eafb33cc75f9" name="Bison" alias="HOW"/>
            <team id="692e1f0e-3c3a-4223-b2cf-7bbc58cf4977" name="Rockets" alias="TOL"/>
            <team id="6b77703c-545d-4c17-a4bb-1fd0bf715257" name="Bengals" alias="IDS"/>
            <team id="6c04ed00-92e9-40ae-8a83-c4733e81f2b3" name="Red Foxes" alias="MST"/>
            <team id="6eef6abb-cb49-4f47-8441-775461d12d4d" name="Owls" alias="SCSU"/>
            <team id="6f81c322-8398-4f16-83ee-d10cd85e2184" name="Golden Flashes" alias="KNT"/>
            <team id="6fad29be-d988-4014-9640-ad26a14d3bd1" name="Orange" alias="SYR"/>
            <team id="6fddb136-b83b-4f5f-8574-54e5581aeaae" name="Beavers" alias="ORS"/>
            <team id="709c25ab-2674-4d9f-9571-69c5ee9363b6" name="Golden Gophers" alias="MIN"/>
            <team id="71c1879b-9dfb-43a2-8476-c9cd283c0827" name="Trojans" alias="TRY"/>
            <team id="72638a86-ccd4-46b6-aa0d-d14066b11966" name="Trojans" alias="TUT"/>
            <team id="7268f3da-94eb-43c0-86c0-a37f854d5c9d" name="Mountaineers" alias="WVU"/>
            <team id="7293edba-9810-444b-9df1-709c24d1c522" name="Huskies" alias="WAS"/>
            <team id="772536c7-c3e8-40d1-ac6e-232d719dc052" name="Tigers" alias="MIZ"/>
            <team id="776b1d36-eb57-437c-8827-1344b03c7593" name="Golden Tigers" alias="TUSKU"/>
            <team id="77ffe1ca-a84c-4779-9293-345dcfb2c4ce" name="Thundering Herd" alias="MSH"/>
            <team id="79368b86-8bb0-4c66-8189-b836d039c207" name="Tar Heels" alias="NC"/>
            <team id="79a845fe-3a55-4db9-97ea-aa921e963087" name="Mustangs" alias="WNMU"/>
            <team id="7a04d7e0-90cb-4497-8622-c53e284c2c19" name="Golden Eagles" alias="USM"/>
            <team id="7b1dbcdb-34b2-479e-9b6b-4c7221e7f743" name="Gamecocks" alias="SC"/>
            <team id="7b5a4b0e-d443-469e-8639-a27f8a3b5d55" name="Bulldogs" alias="SCS"/>
            <team id="7c3a4847-5a1d-422f-b15b-dcc5f8cc5e24" name="Tigers" alias="MEM"/>
            <team id="7cea6bcb-8ecd-4c92-9b13-31345051ab82" name="Cardinal" alias="STA"/>
            <team id="7d99220b-0148-457e-a802-5b395f54462d" name="Dragons" alias="LANE"/>
            <team id="7dbca160-b9d8-4da4-8176-2445cb4b34d2" name="Badgers" alias="WIS"/>
            <team id="7f6bddcc-db68-4bcc-9450-43274e5556ab" name="Minutemen" alias="UMASS"/>
            <team id="8109f68e-0caa-4dab-92fe-eb862c6e39c5" name="Cardinals" alias="LAM"/>
            <team id="8177772e-e8b5-44c6-8dc2-a745b863ec3b" name="Commodores" alias="VAN"/>
            <team id="828f719f-d208-4c23-b69a-8db47318a7a8" name="Keydets" alias="VMI"/>
            <team id="82adc0a0-d140-11ec-bd73-5fb6b9dd2642" name="Seahawks" alias="KUS"/>
            <team id="83bca544-81f2-46cd-8f83-3fe8dbd73a33" name="Golden Hurricane" alias="TSA"/>
            <team id="844c8d83-ee90-46a1-a943-2b5db4c5cb21" name="Bearkats" alias="SHS"/>
            <team id="84a2e6d9-1c1b-47f0-ba71-10dc03f05a0f" name="Raiders" alias="CGT"/>
            <team id="858b3a2b-f9c3-4497-a707-733cc1ea7516" name="Cavaliers" alias="UVA"/>
            <team id="868731af-6062-409f-841d-73e6f8ec3b99" name="Penguins" alias="YSU"/>
            <team id="86ea7237-2634-4ce2-bbc4-6538776b930e" name="Greyhounds" alias="AC"/>
            <team id="86fd55fa-3c1e-4dbe-beee-1853dbc88900" name="Golden Eagles" alias="TNT"/>
            <team id="87fcaa51-93ab-44a6-8236-23d73fb73226" name="Crusaders" alias="NGU"/>
            <team id="882d5415-fa65-40a0-9cdf-afe51ca30ce0" name="Phoenix" alias="ELO"/>
            <team id="8a7fc6b5-bd34-4b66-8e08-8e6562b9248d" name="Bears" alias="MGN"/>
            <team id="8b8225f5-eb09-48ea-9120-cef081918b7a" name="Bears" alias="BAY"/>
            <team id="8bea15d4-278d-4578-a7b4-dcf3af54c334" name="Mountain Hawks" alias="LEI"/>
            <team id="8c01427f-021a-449f-8fc8-e8c6ed01f340" name="Catamounts" alias="WC"/>
            <team id="8c345b64-d751-44aa-852f-8c30db72ffdc" name="Wildcats" alias="NW"/>
            <team id="8cf5c880-678f-400e-b4c2-04ae676ed538" name="Paladins" alias="FUR"/>
            <team id="8d392cef-6e01-4cb7-ac37-b2a1878adea5" name="Miners" alias="MUST"/>
            <team id="8e99908e-4ff2-4465-8e1b-156dcf7aa69d" name="Panthers" alias="FIU"/>
            <team id="8f496f34-14e3-4ca7-958b-53f6da0b74d6" name="Trojans" alias="USC"/>
            <team id="9019d9cc-d8e7-4241-99f3-9a335b2aabbc" name="Lumberjacks" alias="NAZ"/>
            <team id="90d576f6-50f9-42bc-aa31-92bfd0597cb1" name="Skyhawks" alias="TNM"/>
            <team id="917a7888-4be2-4ad5-912d-32f79af931c4" name="Lions" alias="UNA"/>
            <team id="91d73565-e7a5-492d-9b2d-0201fb2be141" name="Trailblazers" alias="UTU"/>
            <team id="930bc744-6ac6-4164-8bf2-c4b46ccaad21" name="Big Green" alias="DRT"/>
            <team id="95404613-f4f0-4280-ac27-85419215f8d1" name="Tigers" alias="CLE"/>
            <team id="96c9ed4c-75c8-4141-9a46-e38855b13087" name="Golden Bears" alias="MILES"/>
            <team id="97673f68-cb54-4025-abe6-c8ea0e2ec7d9" name="Warriors" alias="HAW"/>
            <team id="987bccc6-f5c6-45a2-b0a5-a25702e5c3d5" name="Vandals" alias="IDA"/>
            <team id="98833e65-ab72-482d-b3c0-13f8656629c0" name="Cornhuskers" alias="NEB"/>
            <team id="98f25c6f-f79c-447b-8131-700f826d388a" name="Bulldogs" alias="SAM"/>
            <team id="99562f49-a84d-4f6f-9ad4-949773430431" name="Blue Raiders" alias="MTS"/>
            <team id="99c8011a-35c8-49d9-8ae7-36386b8a4e23" name="Lions" alias="CMB"/>
            <team id="9a6d6f3f-021e-4ddd-8fac-ac4766239d87" name="Buckeyes" alias="OSU"/>
            <team id="9cdcab2b-d599-44dd-9939-c4e6d59587cb" name="Fighting Hawks" alias="UND"/>
            <team id="9e028d90-7fe0-4a3f-8a6c-c5b5115e12fc" name="Bobcats" alias="TXST"/>
            <team id="9e33183c-7e35-4738-9051-719dd7b32e9c" name="Wildcats" alias="ARI"/>
            <team id="9ecb9f6b-df4a-4a92-aaa4-5d50a5286bdd" name="Volunteers" alias="TEN"/>
            <team id="9f40a53c-d4bc-4d58-8208-2227634f9454" name="Falcons" alias="AF"/>
            <team id="9f7a0ea2-afe0-4eae-b5de-3c31910c600a" name="Bulldogs" alias="YAL"/>
            <team id="a12fcb3c-9e0c-489d-a6a9-1a206c3da09c" name="Bobcats" alias="OHI"/>
            <team id="a17404cf-ae20-4bff-bef5-24f70008b2e0" name="Blue Hose" alias="PRES"/>
            <team id="a18d7cf8-1263-45f2-a938-04032d2f7cf5" name="Buffaloes" alias="COL"/>
            <team id="a2ee495d-37c7-45ac-ac3d-d3a492a219c1" name="Hawkeyes" alias="IOW"/>
            <team id="a3d9d315-cbf9-44bd-bfcc-b91e756ac5f2" name="Bears" alias="NOCO"/>
            <team id="a4519544-6513-4ed9-bc6b-3b8c415530c3" name="Hornets" alias="CSUS"/>
            <team id="a5431871-5205-4288-bb00-72fc0360523d" name="Hawks" alias="MNM"/>
            <team id="a5ef8db1-5d26-4d7e-af22-b21e380c16d2" name="Panthers" alias="PIT"/>
            <team id="a60012f8-dc22-4c7d-9d1b-c00cdc3e9c97" name="Scarlet Knights" alias="RUT"/>
            <team id="a610942f-820c-4fc7-9a32-79df473a3e6b" name="Huskies" alias="MTU"/>
            <team id="a62b2dda-d22c-47bf-ad2c-60c66e64d8c7" name="Cowboys" alias="WYO"/>
            <team id="a676268a-159e-4625-bb5d-b3929c1f67f6" name="Seahawks" alias="WAG"/>
            <team id="a7077ca3-a4e4-427d-9c8a-c16b9dcb3472" name="Wildcats" alias="BCU"/>
            <team id="a90583d2-3576-4abc-906e-974e84a4b2f0" name="Zips" alias="AKR"/>
            <team id="a92d587c-2564-4935-a9e4-d26d6437c171" name="Flyers" alias="DAY"/>
            <team id="a9ea6143-d1c9-414d-81ff-7c57a10baf1f" name="Fightin Blue Hens" alias="DEL"/>
            <team id="ae68bc50-4135-47b5-b2f1-03d0669e54c8" name="Longhorns" alias="TEX"/>
            <team id="afc35bbf-6f0a-4710-9034-edb2f4d0c1c1" name="Rams" alias="WSSU"/>
            <team id="b01ba890-a0d2-4b04-a607-a2fc2f5fce86" name="Jaguars" alias="SU"/>
            <team id="b0708df4-2923-4756-8504-6a3bba7d70a6" name="Bears" alias="BRN"/>
            <team id="b1a9ddff-373c-43f1-a562-8c7a235d54ab" name="Bears" alias="UCA"/>
            <team id="b1ff8076-e373-4b6a-ab0f-7f8f86bf0370" name="Midshipmen" alias="NAV"/>
            <team id="b33187c4-a906-4cff-b15b-f1bcb410a743" name="Red Wolves" alias="ARKS"/>
            <team id="b38454be-5f7b-4da0-915e-f5ec909e6fa0" name="Aggies" alias="NAT"/>
            <team id="b3eaa1b0-3e95-417d-80e8-77d3b93f23ac" name="Sharks" alias="LIUCWP"/>
            <team id="b59ad9ae-b8ec-4f8e-9bd2-ec5b4af41e57" name="Dukes" alias="JM"/>
            <team id="b6fa0a24-da86-4c1d-aed7-7aad175cd249" name="Jaguars" alias="SAB"/>
            <team id="b845a41f-2606-478f-a458-3fee79588ad8" name="Roadrunners" alias="UTSA"/>
            <team id="b8828f0f-d7bb-4e7e-a278-854f509838e1" name="Highland Cavaliers" alias="UVW"/>
            <team id="bafc0723-5b94-41da-9212-ac368281659c" name="Hoyas" alias="GTOWN"/>
            <team id="bd9c2213-ffd1-4009-aa75-37f5bdfc4f03" name="Tigers" alias="TNST"/>
            <team id="c14ef8dc-4d15-401f-a47a-74f15f372b04" name="Owls" alias="TEM"/>
            <team id="c33dd300-2cc3-4a53-ab01-be4d65c74e1e" name="Panthers" alias="EIL"/>
            <team id="c3938316-631f-41fb-8f89-2c566118228e" name="Colonials" alias="RM"/>
            <team id="c4ae5e6a-75dd-47ad-8a5f-6aa5b20cc2cb" name="Lions" alias="FMU"/>
            <team id="c4d1b382-e6a4-4fce-aae8-d0a6ec133e8c" name="Tigers" alias="TWN"/>
            <team id="c4f1932a-16ec-45b7-a321-38acef929d03" name="Pioneers" alias="SCH"/>
            <team id="c556a8d0-3c67-4a02-a3ba-2e74398ba3f2" name="Wildcats" alias="ACU"/>
            <team id="c5dea9dd-3129-40e9-ba3d-363f9411a30e" name="Lions" alias="TAMC"/>
            <team id="c6ce892d-c14d-44cd-ad3a-7d4ed60ee1f9" name="Runnin' Bulldogs" alias="GWB"/>
            <team id="c7384d59-3901-4342-8dbc-31801d925d11" name="Monarchs" alias="ODU"/>
            <team id="c765cbff-99d8-4c43-8f6b-e49577ca18fa" name="Gators" alias="FLA"/>
            <team id="c951e9e7-f0b8-4da6-9913-b35572316314" name="Owls" alias="FAU"/>
            <team id="cb71f759-0c22-4be7-babe-3cb849fd1b5e" name="Wildcats" alias="DAV"/>
            <team id="cc1b918c-1523-4412-8b1e-2219d88f11b8" name="Bears" alias="MER"/>
            <team id="cd66228e-16d4-4753-8af9-d40f0bdc24d6" name="Blazers" alias="UAB"/>
            <team id="d0212bdb-5dd4-4604-a221-9adf26e6fd4a" name="Jayhawks" alias="KAN"/>
            <team id="d123c57b-846b-431a-a211-0decf17f0e62" name="Lions" alias="LINU"/>
            <team id="d23058c1-7aaa-44cd-995b-b4be7078df22" name="Black Knights" alias="ARM"/>
            <team id="d335c726-44aa-4b69-8271-59d42d691cba" name="Cyclones" alias="ISU"/>
            <team id="d37b8146-a1f6-4f57-8569-884073b3d071" name="Greyhounds" alias="ENMU"/>
            <team id="d3e8c416-e643-4d5e-be9e-c598a150b234" name="Wolverines" alias="MICH"/>
            <team id="d476d0cc-db5d-463d-ae30-5075ecb3c548" name="Dragons" alias="VLB"/>
            <team id="d4e8867e-8465-451e-b196-5e152769f023" name="Red Flash" alias="STF"/>
            <team id="d5199a36-7f26-4c3b-be48-9599039e232c" name="Aggies" alias="TXAM"/>
            <team id="d5a80ec8-0cdb-401e-a68b-a646d30b3554" name="Buccaneers" alias="ETSU"/>
            <team id="d70a06f4-b708-447b-b05a-f518695cda42" name="Panthers" alias="PRV"/>
            <team id="d7a03859-f629-4b91-af0a-3bd86a6a3e7f" name="Tigers" alias="JST"/>
            <team id="d7f19bff-74e7-4b71-a221-12dfeb144fd8" name="Fighting Irish" alias="ND"/>
            <team id="d89b5e61-f3e4-4cf5-98c1-f7e0ec9a76ab" name="Great Danes" alias="ALB"/>
            <team id="d8c41c53-e302-4425-b95d-532bdbf868a2" name="Hornets" alias="ALAST"/>
            <team id="da45fbb4-54a4-4b21-8682-c26c5d85061c" name="Bears" alias="MIZST"/>
            <team id="da992ee8-f2dd-4196-a74a-c1ca4cd2d559" name="Mountaineers" alias="APP"/>
            <team id="dbfc255d-ee7c-4b1a-9b42-dd822f7ec901" name="Wildcats" alias="LOC"/>
            <team id="dc99beff-fa60-40a8-8b8a-316f7cea3e93" name="Golden Rams" alias="ASUG"/>
            <team id="dd35a796-5290-4866-a4d2-4abc6849ba6d" name="Wolves" alias="WOU"/>
            <team id="ddb9ab12-01d2-4d1c-b40d-39790c1837c7" name="Wildcats" alias="IWU"/>
            <team id="dde53ce9-ee62-44e6-98c5-060a9a97bd10" name="Spartans" alias="NFS"/>
            <team id="deb0920f-c4ca-414d-be4b-ca779e353bf0" name="Blue Devils" alias="DUK"/>
            <team id="deea4446-2bee-4144-96bc-9f1e8ccceee8" name="Colonels" alias="NIC"/>
            <team id="dfde9bcf-f6ed-44a8-ae71-5b37245ad7da" name="Statesmen" alias="DELST"/>
            <team id="e0f7a166-aa14-4979-9d7d-44f36c1e13a6" name="Redbirds" alias="ILS"/>
            <team id="e2492d05-9414-41fb-b7ef-99b27cf358e6" name="Gamecocks" alias="JVS"/>
            <team id="e2a2c23d-3d8d-4f9e-9bed-8a432071f1a7" name="Governors" alias="APY"/>
            <team id="e2a7ee48-c096-4aac-a7a2-4f1f35baa835" name="Terrapins" alias="MAR"/>
            <team id="e346442f-9228-4e94-8e9a-376c5ef7e796" name="Cowboys" alias="OKS"/>
            <team id="e38b87e4-46f0-448e-b155-853abea2b437" name="Oaklanders" alias="LUCA"/>
            <team id="e3ad753c-88b0-4ae9-b6c0-2f726e2ecc24" name="Big Red" alias="COR"/>
            <team id="e3b9e7df-4b69-4d27-9948-59491c29be86" name="Pirates" alias="ECU"/>
            <team id="e3df6700-2881-4b02-a170-f397bb5718a9" name="Rebels" alias="MIS"/>
            <team id="e5bbd1bd-0d65-4581-8d9c-58b33fd5ce62" name="Tigers" alias="AUB"/>
            <team id="e65ef52d-6a34-426e-816e-040258d2f33b" name="Hilltoppers" alias="WKY"/>
            <team id="e7268e7f-a453-4f46-b005-689d1d4966d4" name="Aggies" alias="UTS"/>
            <team id="e7805203-b88d-42f2-8d9b-dd66b1b8ae3d" name="Leopards" alias="LAF"/>
            <team id="eacced25-52d9-4c27-ab9d-ea9aef995e82" name="Bulls" alias="USF"/>
            <team id="ed05b9d3-0086-49bb-9ea5-329ab0d0729b" name="Texans" alias="TSU"/>
            <team id="ed169b71-75b4-40dd-ae28-8e17519c06ba" name="Broncos" alias="WMC"/>
            <team id="edc91db3-9a77-4af6-aa9b-b8a67930ba51" name="Spartans" alias="SJS"/>
            <team id="eeb3ce19-6ddd-4c91-afab-811c6cc81974" name="Nittany Lions" alias="PSU"/>
            <team id="eed7f0d6-72e6-4488-8baa-5ee8e3375ba9" name="Golden Bears" alias="CAL"/>
            <team id="efc41557-a738-43fa-9519-8fd0734923f9" name="Cowboys" alias="MCN"/>
            <team id="f049d124-7d8f-4259-b257-ad154c4d5964" name="Bulldogs" alias="CIT"/>
            <team id="f2874e00-e446-11ec-997e-b9b31b9613e9" name="Saints" alias="TMU"/>
            <team id="f4593f19-1082-4238-b519-09faadbeca37" name="Rams" alias="FOR"/>
            <team id="f4a0ba75-0d10-4ef9-95ac-66eaa44e0851" name="Eagles" alias="CSC"/>
            <team id="f5682334-edd4-42ef-a4fb-5a1474875b9b" name="Tigers" alias="GRA"/>
            <team id="f569e80e-ddce-4de6-a5cd-427f3e1454d0" name="Tigers" alias="EWC"/>
            <team id="f6f4a672-6368-45aa-98d0-3756da844114" name="Aggies" alias="NMS"/>
            <team id="f870de05-89cf-48fc-9649-8cfa325f8f66" name="Lions" alias="MHC"/>
            <team id="f8aa1b62-9622-4a2b-a202-e16d4fb9b90b" name="Bulldogs" alias="BART"/>
            <team id="f8e7c5f8-5865-4e7c-b221-c88a464f8f28" name="Eagles" alias="NCC"/>
            <team id="f9ae197b-be07-4c7b-9149-2e134cf4b677" name="Tigers" alias="TSO"/>
            <team id="fa0eb091-8e35-49c7-b00f-269794a99a61" name="Hoosiers" alias="IU"/>
            <team id="fa28c870-d148-11ec-8af1-3598bba809d8" name="Leopards" alias="LVL"/>
            <team id="fa355cca-bfb2-4282-9656-3e1869d26eef" name="Bearcats" alias="SBU"/>
            <team id="fbd30b5d-6d84-49f7-abf1-c2c73f9e2458" name="Tigers" alias="PRI"/>
            <team id="fc96c960-dd08-11ec-ad0e-ef7bd5e8ba49" name="Eagles" alias="POST"/>
            <team id="fce005d9-c29b-4f9c-836b-92a25e765f28" name="Hornets" alias="DLS"/>
            <team id="fefae711-b307-4fd4-b0d2-c9df51f5ae1c" name="Bobcats" alias="MOS"/>
            <team id="ff330f91-bacc-4c43-b14e-604c58115ebd" name="Mustangs" alias="CPS"/>
            <team id="ffca4209-dbfa-4597-b25a-ed19bb351037" name="Tigers" alias="LSU"/>
        </bye_week>
    </week>
</season>



Player Statuses


What are the player statuses and their descriptions?

Below is a list of the currently valid player statuses and their descriptions. Note that additional decommissioned statuses may appear in older seasons.

  • ACT - Active
  • DUP - Duplicate player profile. All profiles marked as duplicates can be ignored.
  • EXE - Exempt
  • NWT - Not with team
  • PRA - Practice Squad
  • SUS - Suspended

What are the player game statuses and when can I expect them to populate?

Below is a list of currently valid player game statuses.

  • deactivated
  • dnp (Did Not Play)
  • played
  • started

These player game statuses will appear within the Game Roster feed exclusively.

When a game is set to created all players are marked as dnp (Did Not Play). At the conclusion of the game players are adjusted to started and played as necessary.


What are the possible in-game player status updates (player.in_game_status) I can expect to see in the Game Roster endpoint?

Here are the valid in-game player statuses we provide:

  • active
  • probable
  • questionable
  • doubtful
  • out
  • benched
  • unknown


Player Positions


What are the player positions I can expect to see?

Below is a list of player positions that appear in our feeds and their descriptions. Note that additional decommissioned positions may appear in older seasons.

  • ATH - Athlete
  • C - Center
  • CB - Cornerback
  • DB - Defensive Back
  • DE - Defensive End
  • DL - Defensive Lineman
  • DT - Defensive Tackle
  • FB - Fullback
  • FS - Free Safety
  • G - Offensive Guard
  • ILB - Inside Linebacker
  • K - Kicker
  • K/P - Kicker/Punter
  • KR - Kick Returner
  • LB - Linebacker
  • LS - Long Snapper
  • MLB - Middle Linebacker
  • NT - Nose Tackle
  • OG - Offensive Guard
  • OL - Offensive Lineman
  • OLB - Outside Linebacker
  • OT - Offensive Tackle
  • P - Punter
  • QB - Quarterback
  • RB - Running Back
  • S - Safety
  • SS - Strong Safety
  • T - Offensive Tackle
  • TE - Tight End
  • WR - Wide Receiver

How are player positions handled in the feeds?

Players may receive a “game” position. That position may not match the position listed on the player’s profile outside the game.



Play Types & Details


What are the event types I can expect to see in the feeds?

Here are the valid event types:

  • setup
  • timeout
  • tv_timeout
  • two_minute_warning
  • comment
  • period_end
  • game_over

What are the play types I can expect to see in the feeds?

Here are the valid play types:

  • pass
  • rush
  • faircatch_kick
  • extra_point
  • conversion
  • free_kick
  • kickoff
  • punt
  • field_goal
  • penalty

What are the possible detail categories I can expect to see in the feeds?

Here are the valid detail categories:

  • aborted_snap
  • aborted_snap_recovery
  • blocked_kick
  • blocked_kick_recovery
  • defensive_conversion_fumble_recovery
  • defensive_conversion_interception_recovery
  • defensive_conversion_recovery
  • downed
  • extra_point_attempt
  • fair_catch
  • field_goal
  • field_goal_return
  • first_down
  • forced_fumble
  • fourth_down_conversion
  • fumble
  • fumble_out_of_bounds
  • kick_off
  • kick_off_return
  • kneel
  • lateral
  • muffed_kick
  • muffed_punt
  • no_play
  • onside_kick_off
  • onside_kick_off_recovery
  • opponent_aborted_snap_recovery
  • opponent_blocked_kick_recovery
  • opponent_fumble_recovery
  • out_of_bounds
  • own_aborted_snap_recovery
  • own_blocked_kick_recovery
  • own_fumble_recovery
  • pass
  • pass_completion
  • pass_incompletion
  • pass_interception
  • pass_interception_return
  • pass_reception
  • penalty
  • punt
  • punt_return
  • pushed_out_of_bounds
  • ran_out_of_bounds
  • review
  • rush
  • sack
  • safety
  • scramble
  • spike
  • stat_correction
  • tackle
  • team_timeout
  • third_down_conversion
  • touchback
  • touchdown
  • two_point_attempt
  • two_point_pass
  • two_point_return
  • two_point_result
  • two_point_rush
<detail category="pass_incompletion" sequence="1" direction="short middle">
    <description>J.Allen pass incomplete short middle intended for D.Knox.</description>
    <start_location alias="BUF" yardline="42"/>
    <end_location alias="BUF" yardline="45"/>
    <players>
        <player id="5fb525c5-4e70-4ede-8c49-94ad0cf66b7d" name="Dawson Knox" jersey="88" position="TE" sr_id="sr:player:1229734" role="receive"/>
        <player id="3069db07-aa43-4503-ab11-2ae5c0002721" name="Josh Allen" jersey="17" position="QB" sr_id="sr:player:1208608" role="pass"/>
    </players>
</detail>
{
    "category": "pass_incompletion",
    "description": "J.Allen pass incomplete short middle intended for D.Knox.",
    "sequence": 1,
    "direction": "short middle",
    "start_location": {
        "alias": "BUF",
        "yardline": 42
    },
    "end_location": {
        "alias": "BUF",
        "yardline": 45
    },
    "players": [
        {
            "id": "5fb525c5-4e70-4ede-8c49-94ad0cf66b7d",
            "name": "Dawson Knox",
            "jersey": "88",
            "position": "TE",
            "sr_id": "sr:player:1229734",
            "role": "receive"
        },
        {
            "id": "3069db07-aa43-4503-ab11-2ae5c0002721",
            "name": "Josh Allen",
            "jersey": "17",
            "position": "QB",
            "sr_id": "sr:player:1208608",
            "role": "pass"
        }
    ]
}

What are the possible review type values in play details?

Below are possible detail - review.type values.

The review/challenge outcome appears under review.result as either overturned or upheld. In cases where a team initiates a challenge (rather than an official review), a team object will appear within review.

  • backward pass
  • first down
  • fumble
  • illegal forward pass
  • ineligible receiver
  • kick touched
  • loose ball recovery
  • pass completion
  • pass interception
  • potential foul
  • runner broke the plane
  • runner was down by contact
  • running into the kicker
  • safety
  • short of the line to gain
  • targeting
  • tipped pass
  • too many players on field
  • touchback
<play id="4ccd30f0-7874-11ef-9ea0-87f6e5b5da31" sequence="1726962782831.0" clock="8:26" home_points="0" away_points="0" wall_clock="2024-09-21T23:52:50+00:00" fake_punt="false" fake_field_goal="false" screen_pass="false" play_action="false" run_pass_option="false" created_at="2024-09-21T23:53:02+00:00" updated_at="2024-09-21T23:53:22+00:00" type="rush">
  <start_situation clock="8:26" down="2" yfd="9">
    <possession id="a2ee495d-37c7-45ac-ac3d-d3a492a219c1" name="Hawkeyes" market="Iowa" alias="IOW"/>
    <location id="709c25ab-2674-4d9f-9571-69c5ee9363b6" name="Golden Gophers" market="Minnesota" alias="MIN" yardline="24"/>
  </start_situation>
  <end_situation clock="8:16" down="1" yfd="1">
    <possession id="a2ee495d-37c7-45ac-ac3d-d3a492a219c1" name="Hawkeyes" market="Iowa" alias="IOW"/>
    <location id="709c25ab-2674-4d9f-9571-69c5ee9363b6" name="Golden Gophers" market="Minnesota" alias="MIN" yardline="1"/>
  </end_situation>
  <description>K.Johnson rushed for yards. TOUCHDOWN. The Replay Official reviewed the runner was in bounds and the play was overturned. K.Johnson rushed for 23 yards. Pushed out of bounds by C.Bryson at MIN 1.</description>
  <statistics>
    <rush attempt="1" yards="23" firstdown="1" inside_20="0" goaltogo="0">
      <team id="a2ee495d-37c7-45ac-ac3d-d3a492a219c1" name="Hawkeyes" market="Iowa" alias="IOW"/>
      <player id="3992e590-8f40-11ec-9f33-1965c9c46e44" name="Kaleb Johnson" jersey="02" position="RB"/>
    </rush>
    <defense tackle="1" category="defense">
      <team id="709c25ab-2674-4d9f-9571-69c5ee9363b6" name="Golden Gophers" market="Minnesota" alias="MIN"/>
      <player id="83a4bd00-94f6-11ec-9cc1-274e654b69fe" name="Coleman Bryson" jersey="16" position="DB"/>
    </defense>
    <first_down category="rush">
      <team id="a2ee495d-37c7-45ac-ac3d-d3a492a219c1" name="Hawkeyes" market="Iowa" alias="IOW"/>
      <player id="team" name="(Team)"/>
    </first_down>
  </statistics>
  <details>
    <detail category="rush" sequence="0" result="nullified touchdown">
      <description>K.Johnson rushed for yards.</description>
      <start_location alias="MIN" yardline="24"/>
      <end_location alias="MIN" yardline="0"/>
      <players>
        <player id="3992e590-8f40-11ec-9f33-1965c9c46e44" name="Kaleb Johnson" jersey="02" position="RB" role="rush"/>
      </players>
    </detail>
    <detail category="touchdown" sequence="1" result="touchdown">
      <description>TOUCHDOWN.</description>
      <start_location alias="MIN" yardline="0"/>
      <end_location alias="MIN" yardline="0"/>
      <players>
        <player id="3992e590-8f40-11ec-9f33-1965c9c46e44" name="Kaleb Johnson" jersey="02" position="RB" role="rush"/>
      </players>
    </detail>
    <detail category="review" sequence="2">
      <description>The Replay Official reviewed the runner was in bounds and the play was overturned.</description>
      <start_location alias="MIN" yardline="0"/>
      <end_location alias="MIN" yardline="24"/>
      <review result="overturned" type="runner was in bounds" reversed="true">
      </review>
      <players>
      </players>
    </detail>
    <detail category="rush" sequence="3" yards="23" result="pushed out of bounds">
      <description>K.Johnson rushed for 23 yards.</description>
      <start_location alias="MIN" yardline="24"/>
      <end_location alias="MIN" yardline="1"/>
      <players>
        <player id="3992e590-8f40-11ec-9f33-1965c9c46e44" name="Kaleb Johnson" jersey="02" position="RB" role="rush"/>
      </players>
    </detail>
    <detail category="pushed_out_of_bounds" sequence="4">
      <description>Pushed out of bounds by C.Bryson at MIN 1.</description>
      <start_location alias="MIN" yardline="1"/>
      <end_location alias="MIN" yardline="1"/>
      <players>
        <player id="83a4bd00-94f6-11ec-9cc1-274e654b69fe" name="Coleman Bryson" jersey="16" position="DB" role="tackle"/>
      </players>
    </detail>
    <detail category="first_down" sequence="5" result="rush">
      <description/>
      <start_location alias="MIN" yardline="1"/>
      <end_location alias="MIN" yardline="1"/>
      <players>
        <player id="team" name="(Team)" role="first_down"/>
      </players>
    </detail>
  </details>
</play>
{
  "type": "play",
  "id": "4ccd30f0-7874-11ef-9ea0-87f6e5b5da31",
  "sequence": 1726962782831.0,
  "clock": "8:26",
  "home_points": 0,
  "away_points": 0,
  "play_type": "rush",
  "wall_clock": "2024-09-21T23:52:50+00:00",
  "description": "K.Johnson rushed for yards. TOUCHDOWN. The Replay Official reviewed the runner was in bounds and the play was overturned. K.Johnson rushed for 23 yards. Pushed out of bounds by C.Bryson at MIN 1.",
  "fake_punt": false,
  "fake_field_goal": false,
  "screen_pass": false,
  "play_action": false,
  "run_pass_option": false,
  "created_at": "2024-09-21T23:53:02+00:00",
  "updated_at": "2024-09-21T23:53:22+00:00",
  "start_situation": {
    "clock": "8:26",
    "down": 2,
    "yfd": 9,
    "possession": {
      "id": "a2ee495d-37c7-45ac-ac3d-d3a492a219c1",
      "name": "Hawkeyes",
      "market": "Iowa",
      "alias": "IOW"
    },
    "location": {
      "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6",
      "name": "Golden Gophers",
      "market": "Minnesota",
      "alias": "MIN",
      "yardline": 24
    }
  },
  "end_situation": {
    "clock": "8:16",
    "down": 1,
    "yfd": 1,
    "possession": {
      "id": "a2ee495d-37c7-45ac-ac3d-d3a492a219c1",
      "name": "Hawkeyes",
      "market": "Iowa",
      "alias": "IOW"
    },
    "location": {
      "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6",
      "name": "Golden Gophers",
      "market": "Minnesota",
      "alias": "MIN",
      "yardline": 1
    }
  },
  "statistics": [
    {
      "stat_type": "rush",
      "attempt": 1,
      "yards": 23,
      "firstdown": 1,
      "inside_20": 0,
      "goaltogo": 0,
      "player": {
        "id": "3992e590-8f40-11ec-9f33-1965c9c46e44",
        "name": "Kaleb Johnson",
        "jersey": "02",
        "position": "RB"
      },
      "team": {
        "id": "a2ee495d-37c7-45ac-ac3d-d3a492a219c1",
        "name": "Hawkeyes",
        "market": "Iowa",
        "alias": "IOW"
      }
    },
    {
      "stat_type": "defense",
      "tackle": 1,
      "category": "defense",
      "player": {
        "id": "83a4bd00-94f6-11ec-9cc1-274e654b69fe",
        "name": "Coleman Bryson",
        "jersey": "16",
        "position": "DB"
      },
      "team": {
        "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6",
        "name": "Golden Gophers",
        "market": "Minnesota",
        "alias": "MIN"
      }
    },
    {
      "stat_type": "first_down",
      "category": "rush",
      "player": {
        "id": "team",
        "name": "(Team)"
      },
      "team": {
        "id": "a2ee495d-37c7-45ac-ac3d-d3a492a219c1",
        "name": "Hawkeyes",
        "market": "Iowa",
        "alias": "IOW"
      }
    }
  ],
  "details": [
    {
      "category": "rush",
      "description": "K.Johnson rushed for yards.",
      "sequence": 0,
      "result": "nullified touchdown",
      "start_location": {
        "alias": "MIN",
        "yardline": 24
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 0
      },
      "players": [
        {
          "id": "3992e590-8f40-11ec-9f33-1965c9c46e44",
          "name": "Kaleb Johnson",
          "jersey": "02",
          "position": "RB",
          "role": "rush"
        }
      ]
    },
    {
      "category": "touchdown",
      "description": "TOUCHDOWN.",
      "sequence": 1,
      "result": "touchdown",
      "start_location": {
        "alias": "MIN",
        "yardline": 0
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 0
      },
      "players": [
        {
          "id": "3992e590-8f40-11ec-9f33-1965c9c46e44",
          "name": "Kaleb Johnson",
          "jersey": "02",
          "position": "RB",
          "role": "rush"
        }
      ]
    },
    {
      "category": "review",
      "description": "The Replay Official reviewed the runner was in bounds and the play was overturned.",
      "sequence": 2,
      "start_location": {
        "alias": "MIN",
        "yardline": 0
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 24
      },
      "review": {
        "result": "overturned",
        "type": "runner was in bounds",
        "reversed": true
      },
      "players": []
    },
    {
      "category": "rush",
      "description": "K.Johnson rushed for 23 yards.",
      "sequence": 3,
      "yards": 23,
      "result": "pushed out of bounds",
      "start_location": {
        "alias": "MIN",
        "yardline": 24
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 1
      },
      "players": [
        {
          "id": "3992e590-8f40-11ec-9f33-1965c9c46e44",
          "name": "Kaleb Johnson",
          "jersey": "02",
          "position": "RB",
          "role": "rush"
        }
      ]
    },
    {
      "category": "pushed_out_of_bounds",
      "description": "Pushed out of bounds by C.Bryson at MIN 1.",
      "sequence": 4,
      "start_location": {
        "alias": "MIN",
        "yardline": 1
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 1
      },
      "players": [
        {
          "id": "83a4bd00-94f6-11ec-9cc1-274e654b69fe",
          "name": "Coleman Bryson",
          "jersey": "16",
          "position": "DB",
          "role": "tackle"
        }
      ]
    },
    {
      "category": "first_down",
      "sequence": 5,
      "result": "rush",
      "start_location": {
        "alias": "MIN",
        "yardline": 1
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 1
      },
      "players": [
        {
          "id": "team",
          "name": "(Team)",
          "role": "first_down"
        }
      ]
    }
  ]
},
{
  "type": "play",
  "id": "a3c34e80-7874-11ef-9ea0-87f6e5b5da31",
  "sequence": 1726962871822.0,
  "clock": "8:16",
  "home_points": 0,
  "away_points": 6,
  "play_type": "rush",
  "scoring_play": true,
  "goaltogo": true,
  "wall_clock": "2024-09-21T23:53:56+00:00",
  "description": "K.Johnson rushed for 1 yards. TOUCHDOWN.",
  "scoring_description": "K.Johnson rushed for 1 yards. TOUCHDOWN.",
  "fake_punt": false,
  "fake_field_goal": false,
  "screen_pass": false,
  "play_action": false,
  "run_pass_option": false,
  "created_at": "2024-09-21T23:54:31+00:00",
  "updated_at": "2024-09-22T04:17:57+00:00",
  "start_situation": {
    "clock": "8:16",
    "down": 1,
    "yfd": 1,
    "possession": {
      "id": "a2ee495d-37c7-45ac-ac3d-d3a492a219c1",
      "name": "Hawkeyes",
      "market": "Iowa",
      "alias": "IOW"
    },
    "location": {
      "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6",
      "name": "Golden Gophers",
      "market": "Minnesota",
      "alias": "MIN",
      "yardline": 1
    }
  },
  "end_situation": {
    "clock": "8:03",
    "down": 0,
    "yfd": 0,
    "possession": {
      "id": "a2ee495d-37c7-45ac-ac3d-d3a492a219c1",
      "name": "Hawkeyes",
      "market": "Iowa",
      "alias": "IOW"
    },
    "location": {
      "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6",
      "name": "Golden Gophers",
      "market": "Minnesota",
      "alias": "MIN",
      "yardline": 3
    }
  },
  "score": {
    "sequence": 2,
    "clock": "8:03",
    "points": 7,
    "home_points": 0,
    "away_points": 7,
    "points-after-play": {
      "id": "d88307a0-7874-11ef-9ea0-87f6e5b5da31",
      "sequence": 1726962881521.0,
      "type": "extra_point"
    }
  },
  "statistics": [
    {
      "stat_type": "rush",
      "attempt": 1,
      "yards": 1,
      "touchdown": 1,
      "firstdown": 0,
      "inside_20": 1,
      "goaltogo": 0,
      "player": {
        "id": "3992e590-8f40-11ec-9f33-1965c9c46e44",
        "name": "Kaleb Johnson",
        "jersey": "02",
        "position": "RB"
      },
      "team": {
        "id": "a2ee495d-37c7-45ac-ac3d-d3a492a219c1",
        "name": "Hawkeyes",
        "market": "Iowa",
        "alias": "IOW"
      }
    }
  ],
  "details": [
    {
      "category": "rush",
      "description": "K.Johnson rushed for 1 yards.",
      "sequence": 0,
      "yards": 1,
      "result": "touchdown",
      "start_location": {
        "alias": "MIN",
        "yardline": 1
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 0
      },
      "players": [
        {
          "id": "3992e590-8f40-11ec-9f33-1965c9c46e44",
          "name": "Kaleb Johnson",
          "jersey": "02",
          "position": "RB",
          "role": "rush"
        }
      ]
    },
    {
      "category": "touchdown",
      "description": "TOUCHDOWN.",
      "sequence": 1,
      "yards": 1,
      "result": "touchdown",
      "start_location": {
        "alias": "MIN",
        "yardline": 0
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 0
      },
      "players": [
        {
          "id": "3992e590-8f40-11ec-9f33-1965c9c46e44",
          "name": "Kaleb Johnson",
          "jersey": "02",
          "position": "RB",
          "role": "rush"
        }
      ]
    }
  ]
},

What are the point after score types I can expect to see in the feeds?

Here are the valid score types:

  • extra_point
  • conversion
  • penalty


Statistics


How are assisted sacks calculated in the feeds?

Assisted sacks are credited when two players sack the quarterback. We provide this in the Play-by-Play feed and Game Boxscore as an integer. Those sacks are rolled up into the sacks stat and can be a float.

For example, if a player had 3 ast_sacks and 2 sacks in a game his game-level sack number would be 3.5.

<player id="bc69c92c-58ff-44b2-a18b-07a08ee78dc6" name="Jonathan Greenard" jersey="52" position="DE" 
  sr_id="sr:player:2040593" tackles="3" assists="3" combined="6" sacks="2.5" sack_yards="25.0" 
  interceptions="0" passes_defended="0" forced_fumbles="0" fumble_recoveries="0" qb_hits="4" tloss="2.0" 
  tloss_yards="21.0" safeties="0" sp_tackles="0" sp_assists="0" sp_forced_fumbles="0" sp_fumble_recoveries="0" 
  sp_blocks="0" misc_tackles="0" misc_assists="0" misc_forced_fumbles="0" misc_fumble_recoveries="0" 
  def_targets="0" def_comps="0" blitzes="0" hurries="0" knockdowns="0" missed_tackles="0" batted_passes="0"/>
{
    "id": "bc69c92c-58ff-44b2-a18b-07a08ee78dc6",
    "name": "Jonathan Greenard",
    "jersey": "52",
    "position": "DE",
    "sr_id": "sr:player:2040593",
    "tackles": 3,
    "assists": 3,
    "combined": 6,
    "sacks": 2.5,
    "sack_yards": 25.0,
    "interceptions": 0,
    "passes_defended": 0,
    "forced_fumbles": 0,
    "fumble_recoveries": 0,
    "qb_hits": 4,
    "tloss": 2.0,
    "tloss_yards": 21.0,
    "safeties": 0,
    "sp_tackles": 0,
    "sp_assists": 0,
    "sp_forced_fumbles": 0,
    "sp_fumble_recoveries": 0,
    "sp_blocks": 0,
    "misc_tackles": 0,
    "misc_assists": 0,
    "misc_forced_fumbles": 0,
    "misc_fumble_recoveries": 0,
    "def_targets": 0,
    "def_comps": 0,
    "blitzes": 0,
    "hurries": 0,
    "knockdowns": 0,
    "missed_tackles": 0,
    "batted_passes": 0
},

Are there game statistics you collect that are considered unofficial?

Yes. Tackle information, passes defended, and quarterback hits are considered unofficial. This information will be entered as we view the corresponding events, but are not validated against another source.


Are there any game statistics you enter after a game is moved to closed?

Yes. Tackles may not be completely entered when a game is transferred to closed.

We prioritize offensive, team, and key defensive statistics (like sacks and interceptions) when entering statistics. Tackles, in some cases, are entered in the following week. Use the Change Log endpoint to capture stat updates to games post-closed.



Drives


What are the start and end reasons for a drive that I can expect to see in the feeds?

  • UNKNOWN – Start/End
  • Touchdown – Start/End
  • Safety – End
  • Field Goal – Start/End
  • Missed FG – Start/End
  • Blocked FG – Start/End
  • Blocked FG, Downs – Start/End
  • Blocked FG, Safety – End
  • Punt – Start/End
  • Blocked Punt – Start/End
  • Blocked Punt, Downs – Start/End
  • Blocked Punt, Safety – End
  • Downs – Start/End
  • Interception – Start/End
  • Fumble – Start/End
  • Fumble, Safety - End
  • Muffed FG – Start/End
  • Muffed Punt – Start
  • Muffed Kickoff – Start
  • Kickoff – Start
  • Own Kickoff – Start
  • Onside Kick – Start
  • Kickoff, No Play – Start
  • End of Half – End
  • End of Game – End


Venues


What are the venue roof types I can expect to see?

Here are the valid roof types: outdoor, dome, or retractable_dome


What are the venue surfaces I can expect to see?

Here are the valid venue surfaces: turf or artifical



Scoring


When are the game scores added to the Schedule feeds?

Game and period scores are added to the feed when the game status changes to complete.


Schedules


How do I pull in schedule data for future games in which teams are not yet known?

This API features a TBD team used for every entry in to-be-determined matchups. This virtual team will have its own unique ID specific to this API.

Find the TBD team in the Teams endpoint.

  • <team id="e7ce7680-f058-11ee-89df-6558e107cb95" name="TBD" market="Team" alias="TBD"/>

The matchups will appear as below in the Schedule endpoints.

<series id="0f81bb4d-1d0c-4a3b-82de-507534154095" title="NBA Finals - TBD vs TBD" round="4" start_date="2024-06-06" status="scheduled">
  <games>
  <game id="342f103b-0fd7-47ac-a84d-1391e3605e96" status="time-tbd" title="Game 1" coverage="full" scheduled="2024-06-06T17: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>
<game id="71d8d5fc-6836-43c1-85a0-61a828296a06" status="time-tbd" title="Game 2" coverage="full" scheduled="2024-06-09T17: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>
<game id="50b170b9-37e2-47d0-b517-e56ebb960cba" status="time-tbd" title="Game 3" coverage="full" scheduled="2024-06-12T17: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>
<game id="8e94445c-c223-4a49-a759-0b651e440b95" status="time-tbd" title="Game 4" coverage="full" scheduled="2024-06-14T17: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>
<game id="aaa3ddb3-dd1b-459e-a686-d2bfc4408881" status="if-necessary" title="Game 5 (if necessary)" coverage="full" scheduled="2024-06-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>
<game id="7c16f1ec-6629-4675-aaaa-2a31835862a6" status="if-necessary" title="Game 6 (if necessary)" coverage="full" scheduled="2024-06-20T17: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>
<game id="09129676-2320-4151-976d-713ea785d97b" status="if-necessary" title="Game 7 (if necessary)" coverage="full" scheduled="2024-06-23T17: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": "0f81bb4d-1d0c-4a3b-82de-507534154095",
    "title": "NBA Finals - TBD vs TBD",
    "round": 4,
    "start_date": "2024-06-06",
    "status": "scheduled",
    "participants": [],
    "games": [
      {
        "id": "342f103b-0fd7-47ac-a84d-1391e3605e96",
        "status": "time-tbd",
        "title": "Game 1",
        "coverage": "full",
        "scheduled": "2024-06-06T17: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": "71d8d5fc-6836-43c1-85a0-61a828296a06",
        "status": "time-tbd",
        "title": "Game 2",
        "coverage": "full",
        "scheduled": "2024-06-09T17: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": "50b170b9-37e2-47d0-b517-e56ebb960cba",
        "status": "time-tbd",
        "title": "Game 3",
        "coverage": "full",
        "scheduled": "2024-06-12T17: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": "8e94445c-c223-4a49-a759-0b651e440b95",
        "status": "time-tbd",
        "title": "Game 4",
        "coverage": "full",
        "scheduled": "2024-06-14T17: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": "aaa3ddb3-dd1b-459e-a686-d2bfc4408881",
        "status": "if-necessary",
        "title": "Game 5 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-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": "7c16f1ec-6629-4675-aaaa-2a31835862a6",
        "status": "if-necessary",
        "title": "Game 6 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-20T17: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": "09129676-2320-4151-976d-713ea785d97b",
        "status": "if-necessary",
        "title": "Game 7 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-23T17: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"
        }
      }
    ]
  },

Make note of the status attribute to determine whether the time of the game is known. A status of time-tbd indicates the game has been scheduled, but a time has yet to be announced. A status of scheduled indicates the game time is known.




🙋

More questions?

Reach out to [email protected] for further assistance.