Site
Home / Forum / Developers / int_round Values for MLS Cup Final, NCAA Basketball Tournament, and Non-CFP Bowl Games


int_round Values for MLS Cup Final, NCAA Basketball Tournament, and Non-CFP Bowl Games


Posted: 22 Jun 2026 13:27
scott74
Editor Premium
Edits: 1
Posts: 5
Joined: 2026

1. MLS Cup Final
All MLS playoff games — including the MLS Cup Final — appear to return intRound = 0. We're unable to distinguish the Championship Final from the Conference Finals or earlier rounds. Is there a distinct intRound value assigned to the MLS Cup Final, or is there another field we should be using to identify it?

2. NCAA Men's Basketball (March Madness)
Every NCAAB game we've seen — regular season and NCAA Tournament alike — returns intRound = 0. We need an identifier that shows only NCAA Tournament games, but can't find a reliable way to identify them. Is there a round value, status field, or other indicator that differentiates tournament games from the regular season?

3. College Football Non-CFP Bowl Games
We can successfully identify CFP Playoff and National Championship games using their intRound values. However, we'd also like to surface traditional bowl games that fall outside the CFP bracket (Rose Bowl, Sugar Bowl, etc.). Are these assigned distinct intRound values, or is there another way to identify them as bowl/postseason games?

Any guidance on these three cases would be greatly appreciated.

transparent spacer
Posted: 22 Jun 2026 13:34

zag
Admin
Edits: 184,813
Posts: 4,031
Joined: 2020

Thanks for the reports, basically if intRound is missing then someone needs to edit the event and change it. This is as simple as hitting the yellow "Edit Event" button and changing the round, But can be time consuming if there are a lot of events.

The site is completely editable by any premium member or editor with rights. That's how we work.

transparent spacer
Posted: 22 Jun 2026 13:37

zag
Admin
Edits: 184,813
Posts: 4,031
Joined: 2020

3. You can find the round numbers here https://www.thesportsdb.com/docs_api_data. That's all we allow currently.

We do have a collections feature which could potentially be used to group special one off games. See example here: https://www.thesportsdb.com/collection/21834-euroleague-rivalry-series

transparent spacer
Posted: 22 Jun 2026 13:50

curswine
Admin
Edits: 1,123,759
Posts: 1,224
Joined: 2020

1. MLS Cup Final
All MLS playoff games — including the MLS Cup Final — appear to return intRound = 0. We're unable to distinguish the Championship Final from the Conference Finals or earlier rounds. Is there a distinct intRound value assigned to the MLS Cup Final, or is there another field we should be using to identify it?


There are no playoff games set for the MLS season yet, still far too early. Last season's are there and all have round numbers. https://www.thesportsdb.com/season/4346-american-major-league-soccer/2025&all=1&view=0

2. NCAA Men's Basketball (March Madness)
Every NCAAB game we've seen — regular season and NCAA Tournament alike — returns intRound = 0. We need an identifier that shows only NCAA Tournament games, but can't find a reliable way to identify them. Is there a round value, status field, or other indicator that differentiates tournament games from the regular season?


Again, I do not know where you are getting the information from that the rounds are all 0 for the finals, they simply are not. https://www.thesportsdb.com/season/4607-ncaa-division-i-basketball-mens/2025-2026&all=1&view=0

3. College Football Non-CFP Bowl Games
We can successfully identify CFP Playoff and National Championship games using their intRound values. However, we'd also like to surface traditional bowl games that fall outside the CFP bracket (Rose Bowl, Sugar Bowl, etc.). Are these assigned distinct intRound values, or is there another way to identify them as bowl/postseason games?

Any guidance on these three cases would be greatly appreciated.


As zag stated above you could use the collection feature, you could also manually enter these into the description field. Other than that there is no way to identify them.


transparent spacer
Posted: 22 Jun 2026 17:08
scott74
Editor Premium
Edits: 1
Posts: 5
Joined: 2026

3. You can find the round numbers here https://www.thesportsdb.com/docs_api_data. That's all we allow currently.

We do have a collections feature which could potentially be used to group special one off games. See example here: https://www.thesportsdb.com/collection/21834-euroleague-rivalry-series



Sorry about the confusion on my end. I was trying to figure out the intRound values for March Madness and pulled last year's MLS schedule to confirm the Cup Final uses intRound 200 on the last game.

Is there a reference table somewhere that lists all intRound values with their labels (e.g. 200 = Final, 150 = Semi-Final, etc.)?

It looks like the values may follow a consistent pattern across all leagues — World Series, Super Bowl, NBA Finals, MLS Cup all appear to use 200 for the championship game, with playoffs using lower values like 160/125/150 for earlier rounds. If that's intentional and documented somewhere, that would be really helpful to reference when building integrations.


PS. All Star Game is not in the MLB schedule correct. Was looking for that game and inRound ID but did not see it pulling 2026 or 2025 schedule.
Thanks, Scott

transparent spacer
Posted: 22 Jun 2026 17:45

curswine
Admin
Edits: 1,123,759
Posts: 1,224
Joined: 2020

3. You can find the round numbers here https://www.thesportsdb.com/docs_api_data. That's all we allow currently.

Look at the bottom of the page that zag posted earlier in the thread.

Final will mean the last game, semi-final when there are 4 team left, quarter-final for 8 teams. Then it will depend on the competition on what is correct.

We have to try and make this format work for many competitions across many sports so there are times when a questionable decision is made and a round peg needs to fit in a square hole.

zag
transparent spacer
Posted: 22 Jun 2026 18:46

Ovokx
Admin
Edits: 498,927
Posts: 1,885
Joined: 2020

PS. All Star Game is not in the MLB schedule correct. Was looking for that game and inRound ID but did not see it pulling 2026 or 2025 schedule.
Thanks, Scott


All All-Star events on any sports are on separated leagues. You won't find them on main leagues as they are just exhibitions games

PS: 2026 MLB All-Star Game should be easy to find as it's even currently displayed on "Featured Events" on the landing page

zag
transparent spacer
Posted: 23 Jun 2026 18:38
scott74
Editor Premium
Edits: 1
Posts: 5
Joined: 2026

PS. All Star Game is not in the MLB schedule correct. Was looking for that game and inRound ID but did not see it pulling 2026 or 2025 schedule.
Thanks, Scott

All All-Star events on any sports are on separated leagues. You won't find them on main leagues as they are just exhibitions games

PS: 2026 MLB All-Star Game should be easy to find as it's even currently displayed on "Featured Events" on the landing page


Gracias.. Found the ID an was able to pull the event.
Thanks again


transparent spacer
Showing 0 to 8 (Total: 8)