{
"openapi": "3.1.0",
"info": {
"title": "CWBB API",
"version": "1.0",
"description": "CWBB API - OpenAPI 3.1 Specification"
},
"servers": [
{
"url": "https://api.sportsdata.io",
"description": "Production server"
}
],
"paths": {
"/v3/cwbb/scores/{format}/CurrentSeason": {
"get": {
"description": "Season Current",
"operationId": "cwbb_v3_scores_season_current",
"summary": "Season Current",
"parameters": [
{
"name": "format",
"in": "path",
"description": "Desired response format. Valid entries are JSON or XML.",
"required": true,
"schema": {
"type": "string",
"enum": [
"JSON",
"XML"
],
"default": "JSON"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Season"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
}
}
},
"tags": [
"CWBB v3 Scores"
]
}
},
"/v3/cwbb/scores/{format}/AreAnyGamesInProgress": {
"get": {
"description": "Are Any Games In Progress",
"operationId": "cwbb_v3_scores_are_any_games_in_progress",
"summary": "Are Any Games In Progress",
"parameters": [
{
"name": "format",
"in": "path",
"description": "Desired response format. Valid entries are JSON or XML.",
"required": true,
"schema": {
"type": "string",
"enum": [
"JSON",
"XML"
],
"default": "JSON"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "boolean"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
}
}
},
"tags": [
"CWBB v3 Scores"
]
}
},
"/v3/cwbb/scores/{format}/LeagueHierarchy": {
"get": {
"description": "The list of all conferences and their teams, with standings data.",
"operationId": "cwbb_v3_scores_league_hierarchy",
"summary": "League Hierarchy",
"parameters": [
{
"name": "format",
"in": "path",
"description": "Desired response format. Valid entries are JSON or XML.",
"required": true,
"schema": {
"type": "string",
"enum": [
"JSON",
"XML"
],
"default": "JSON"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Conference"
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
}
}
},
"tags": [
"CWBB v3 Scores"
]
}
},
"/v3/cwbb/scores/{format}/Teams": {
"get": {
"description": "Full team information: school, team name and city, conference and division, and colors.",
"operationId": "cwbb_v3_scores_team_profiles___all",
"summary": "Team Profiles - All",
"parameters": [
{
"name": "format",
"in": "path",
"description": "Desired response format. Valid entries are JSON or XML.",
"required": true,
"schema": {
"type": "string",
"enum": [
"JSON",
"XML"
],
"default": "JSON"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Team"
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
}
}
},
"tags": [
"CWBB v3 Scores"
]
}
},
"/v3/cwbb/scores/{format}/Games/{season}": {
"get": {
"description": "Home and away teams, date and time, season type etc. are included. Also includes gameday information. This includes full stadium information, top-line betting information (spread, moneyline, total), weather conditions, and broadcast information.",
"operationId": "cwbb_v3_scores_schedules",
"summary": "Schedules",
"parameters": [
{
"name": "format",
"in": "path",
"description": "Desired response format. Valid entries are JSON or XML.",
"required": true,
"schema": {
"type": "string",
"enum": [
"JSON",
"XML"
],
"default": "JSON"
}
},
{
"name": "season",
"in": "path",
"description": "Year of the season (with optional season type).
Examples: 2020, 2020PRE, 2020POST, 2019, etc.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Game"
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
}
}
},
"tags": [
"CWBB v3 Scores"
]
}
},
"/v3/cwbb/scores/{format}/GamesByDate/{date}": {
"get": {
"description": "Full scores and gameday info delivered live and post-game. Live data includes half and score info. Gameday info includes weather, TV channel etc",
"operationId": "cwbb_v3_scores_games___by_date__live___final",
"summary": "Games - by Date [Live & Final]",
"parameters": [
{
"name": "format",
"in": "path",
"description": "Desired response format. Valid entries are JSON or XML.",
"required": true,
"schema": {
"type": "string",
"enum": [
"JSON",
"XML"
],
"default": "JSON"
}
},
{
"name": "date",
"in": "path",
"description": "The date of the game(s).
Examples: 2020-FEB-27, 2019-DEC-01.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Game"
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
}
}
},
"tags": [
"CWBB v3 Scores"
]
}
},
"/v3/cwbb/scores/{format}/SchedulesBasic/{season}": {
"get": {
"description": "A lightweight schedule endpoint without gameday information. Home and away teams, the date and time of the game, and season type, week etc. are included. Ideal for the most basic information required to build a schedule.",
"operationId": "cwbb_v3_scores_schedules__basic",
"summary": "Schedules (Basic)",
"parameters": [
{
"name": "format",
"in": "path",
"description": "Desired response format. Valid entries are JSON or XML.",
"required": true,
"schema": {
"type": "string",
"enum": [
"JSON",
"XML"
],
"default": "JSON"
}
},
{
"name": "season",
"in": "path",
"description": "Year of the season (with optional season type).
Examples: 2020, 2020PRE, 2020POST, 2019, etc.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ScheduleBasic"
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
}
}
},
"tags": [
"CWBB v3 Scores"
]
}
},
"/v3/cwbb/scores/{format}/GamesByDateFinal/{date}": {
"get": {
"description": "Full scores and gameday info, including weather, referee, infotainment odds, as well as all of the quarter scores and full-time score, delivered as the game ends.",
"operationId": "cwbb_v3_scores_games___by_date__final",
"summary": "Games - by Date [Final]",
"parameters": [
{
"name": "format",
"in": "path",
"description": "Desired response format. Valid entries are JSON or XML.",
"required": true,
"schema": {
"type": "string",
"enum": [
"JSON",
"XML"
],
"default": "JSON"
}
},
{
"name": "date",
"in": "path",
"description": "The date of the game(s).
Examples: 2020-FEB-27, 2019-DEC-01.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Success",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Game"
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Unauthorized"
}
}
}
}
},
"tags": [
"CWBB v3 Scores"
]
}
}
},
"components": {
"schemas": {
"Unauthorized": {
"properties": {
"HttpStatusCode": {
"type": "integer"
},
"Code": {
"type": "integer"
},
"Description": {
"type": "string"
},
"Help": {
"type": "string"
}
}
},
"Season": {
"properties": {
"CurrentSeason": {
"type": "integer",
"description": "The college basketball season of the game"
},
"StartYear": {
"type": "integer",
"description": "The year in which the season started"
},
"EndYear": {
"type": "integer",
"description": "The year in which the season ended"
},
"Description": {
"type": [
"string",
"null"
],
"description": "The description of this season for display purposes (e.g. 2017-18, 2018-19, etc)"
},
"RegularSeasonStartDate": {
"type": [
"string",
"null"
],
"description": "The start date of the regular season"
},
"PostSeasonStartDate": {
"type": [
"string",
"null"
],
"description": "The start date of the postseason"
},
"ApiSeason": {
"type": [
"string",
"null"
],
"description": "The string to pass into subsequent API calls in the season parameter (e.g. 2025REG, 2025POST, etc.)"
}
}
},
"Conference": {
"properties": {
"ConferenceID": {
"type": "integer",
"description": "The ID of the team's conference"
},
"Name": {
"type": [
"string",
"null"
],
"description": "The name of the team's conference (e.g. American Conference; Big Ten Conference; Conference USA)"
},
"Teams": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Team"
},
"description": "The list of teams within the conference"
}
}
},
"Team": {
"properties": {
"TeamID": {
"type": "integer",
"description": "The unique ID of the team"
},
"Key": {
"type": [
"string",
"null"
],
"description": "A unique abbreviation of the team (e.g. OKL; TXTECH; USC; UK; etc.). Note: Due to being selected for uniqueness; these are not always matching broadcaster abbreviations. For that use case; use ShortDisplayName"
},
"Active": {
"type": "boolean",
"description": "Indicates whether or not this team is active"
},
"School": {
"type": [
"string",
"null"
],
"description": "The name of the team as used in college sports (e.g. SMU; South Florida; Stony Brook; UCLA; etc.)"
},
"Name": {
"type": [
"string",
"null"
],
"description": "The mascot of the team (e.g. Sooners, Red Raiders, Trojans, Wildcats, etc.)"
},
"ApRank": {
"type": [
"integer",
"null"
],
"description": "The AP Rank of the team (1-25)"
},
"Wins": {
"type": [
"integer",
"null"
],
"description": "The total number of wins by the team"
},
"Losses": {
"type": [
"integer",
"null"
],
"description": "The total number of losses by the team"
},
"ConferenceWins": {
"type": [
"integer",
"null"
],
"description": "The total number of conference wins by the team"
},
"ConferenceLosses": {
"type": [
"integer",
"null"
],
"description": "The total number of conference losses by the team"
},
"GlobalTeamID": {
"type": "integer",
"description": "A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues"
},
"ConferenceID": {
"type": [
"integer",
"null"
],
"description": "The ID of the team's conference"
},
"Conference": {
"type": [
"string",
"null"
],
"description": "The name of the team's conference (e.g. American Conference; Big Ten Conference; Conference USA)"
},
"TeamLogoUrl": {
"type": [
"string",
"null"
],
"description": "The URL of the team logo image"
},
"ShortDisplayName": {
"type": [
"string",
"null"
],
"description": "A abbreviation of the team as seen on most broadcasts. Note: This field could have the same name for multiple teams. If a completely unique name is need use [Key]"
},
"PrimaryColor": {
"type": [
"string",
"null"
],
"description": "The team's primary color. (This is not licensed for public or commercial use)"
},
"SecondaryColor": {
"type": [
"string",
"null"
],
"description": "The team's secondary color. (This is not licensed for public or commercial use)"
},
"TertiaryColor": {
"type": [
"string",
"null"
],
"description": "The team's tertiary color. (This is not licensed for public or commercial use)"
},
"QuaternaryColor": {
"type": [
"string",
"null"
],
"description": "The team's quaternary color. (This is not licensed for public or commercial use)"
}
}
},
"Game": {
"properties": {
"GameID": {
"type": "integer",
"description": "The unique ID of the game"
},
"Season": {
"type": "integer",
"description": "The season that the game occurs in Note: season is a single year that the majority of the season occurs in"
},
"SeasonType": {
"type": "integer",
"description": "The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar)"
},
"Status": {
"type": [
"string",
"null"
],
"description": "Indicates the game's status. Possible values include: Scheduled; InProgress; Final; F/OT; Suspended; Postponed; Delayed; Canceled; Forfeit"
},
"Day": {
"type": [
"string",
"null"
],
"description": "The date the game is scheduled to occur"
},
"DateTime": {
"type": [
"string",
"null"
],
"description": "The timestamp of when the game is scheduled to start"
},
"AwayTeam": {
"type": [
"string",
"null"
],
"description": "The abbreviation [Key] of the away team"
},
"HomeTeam": {
"type": [
"string",
"null"
],
"description": "The abbreviation [Key] of the home team"
},
"AwayTeamID": {
"type": [
"integer",
"null"
],
"description": "The unique ID of the away team"
},
"HomeTeamID": {
"type": [
"integer",
"null"
],
"description": "The unique ID of the home team"
},
"AwayTeamScore": {
"type": [
"integer",
"null"
],
"description": "Total number of points the away team scored in the game"
},
"HomeTeamScore": {
"type": [
"integer",
"null"
],
"description": "Total number of points the home team scored in this game"
},
"Updated": {
"type": [
"string",
"null"
],
"description": "The timestamp of when this game was last updated (in US Eastern Time)"
},
"Period": {
"type": [
"string",
"null"
],
"description": "The current quarter of the game (Possible Values: 1, 2, 3, 4, OT, NULL)"
},
"TimeRemainingMinutes": {
"type": [
"integer",
"null"
],
"description": "Number of minutes remaining in the quarter"
},
"TimeRemainingSeconds": {
"type": [
"integer",
"null"
],
"description": "Number of seconds remaining in the quarter"
},
"GlobalGameID": {
"type": "integer",
"description": "A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues"
},
"GlobalAwayTeamID": {
"type": [
"integer",
"null"
],
"description": "A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues"
},
"GlobalHomeTeamID": {
"type": [
"integer",
"null"
],
"description": "A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues"
},
"Periods": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Period"
},
"description": "The details of the periods (quarters & overtime) for this game"
},
"DateTimeUTC": {
"type": [
"string",
"null"
],
"description": "The timestamp in UTC of when the game is scheduled to start"
},
"RescheduledFromGameID": {
"type": [
"integer",
"null"
],
"description": "The GameID of the originally scheduled, postponed game, that this game was rescheduled from. This only pertains to games that are scheduled as \"make up\" games."
},
"RescheduledGameID": {
"type": [
"integer",
"null"
],
"description": "The GameID of the game that was rescheduled from this game. This only pertains to postponed games that require rescheduling."
}
}
},
"Period": {
"properties": {
"PeriodID": {
"type": "integer",
"description": "The unique ID for the period"
},
"GameID": {
"type": "integer",
"description": "The unique ID of the game relating to this period"
},
"Number": {
"type": "integer",
"description": "The number (order) of the period within the scope of the game"
},
"Name": {
"type": [
"string",
"null"
],
"description": "The Name of the Quarter (possible values: 1, 2, 3, 4, OT, OT2, OT3, etc)"
},
"Type": {
"type": [
"string",
"null"
],
"description": "Indicates whether this period is a regulation quarter or overtime (possible values: Quarter, Overtime)"
},
"AwayScore": {
"type": [
"integer",
"null"
],
"description": "The total points scored by the away team in this period only"
},
"HomeScore": {
"type": [
"integer",
"null"
],
"description": "The total points scored by the home team in this period only"
}
}
},
"ScheduleBasic": {
"properties": {
"GameID": {
"type": "integer",
"description": "The unique ID of the game"
},
"Season": {
"type": "integer",
"description": "The season that the game occurs in. Note: season is a single year that the majority of the season occurs in"
},
"SeasonType": {
"type": "integer",
"description": "The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar)"
},
"Status": {
"type": [
"string",
"null"
],
"description": "Indicates the game's status. Possible values include: Scheduled; InProgress; Final; F/OT; Suspended; Postponed; Delayed; Canceled; Forfeit"
},
"Day": {
"type": [
"string",
"null"
],
"description": "The date the game is scheduled to occur"
},
"DateTime": {
"type": [
"string",
"null"
],
"description": "The timestamp of when the game is scheduled to start"
},
"AwayTeam": {
"type": [
"string",
"null"
],
"description": "The abbreviation [Key] of the away team"
},
"HomeTeam": {
"type": [
"string",
"null"
],
"description": "The abbreviation [Key] of the home team"
},
"AwayTeamID": {
"type": [
"integer",
"null"
],
"description": "The unique ID of the away team"
},
"HomeTeamID": {
"type": [
"integer",
"null"
],
"description": "The unique ID of the home team"
},
"AwayTeamScore": {
"type": [
"integer",
"null"
],
"description": "Total number of points the away team scored in the game"
},
"HomeTeamScore": {
"type": [
"integer",
"null"
],
"description": "Total number of points the home team scored in this game"
},
"Updated": {
"type": [
"string",
"null"
],
"description": "The timestamp of when this game was last updated (in US Eastern Time)"
},
"GlobalGameID": {
"type": "integer",
"description": "A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues"
},
"TournamentID": {
"type": [
"integer",
"null"
],
"description": "The unique ID of the tournament"
},
"Bracket": {
"type": [
"string",
"null"
],
"description": "The specific bracket/region of the tournament"
},
"Round": {
"type": [
"integer",
"null"
],
"description": "The current round of the tournament"
},
"AwayTeamSeed": {
"type": [
"integer",
"null"
],
"description": "The seed of the away team (1-16). Note: specific to March Madness tournament & does not include other tournaments"
},
"HomeTeamSeed": {
"type": [
"integer",
"null"
],
"description": "The seed of the home team (1-16). Note: specific to March Madness tournament & does not include other tournaments"
},
"IsClosed": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether the game is over and the final score has been verified and closed out."
},
"GameEndDateTime": {
"type": [
"string",
"null"
],
"description": "The date and time that the game ended (in US Eastern Time)"
},
"NeutralVenue": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether this game is played in a neutral venue"
},
"DateTimeUTC": {
"type": [
"string",
"null"
],
"description": "The timestamp in UTC of when the game is scheduled to start"
},
"GlobalAwayTeamID": {
"type": "integer",
"description": "A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues"
},
"GlobalHomeTeamID": {
"type": "integer",
"description": "A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues"
},
"RescheduledFromGameID": {
"type": [
"integer",
"null"
],
"description": "The GameID of the originally scheduled, postponed game, that this game was rescheduled from. This only pertains to games that are scheduled as \"make up\" games."
},
"RescheduledGameID": {
"type": [
"integer",
"null"
],
"description": "The GameID of the game that was rescheduled from this game. This only pertains to postponed games that require rescheduling."
}
}
}
},
"securitySchemes": {
"apiKeyHeader": {
"type": "apiKey",
"name": "Ocp-Apim-Subscription-Key",
"in": "header"
},
"apiKeyQuery": {
"type": "apiKey",
"name": "key",
"in": "query"
}
}
},
"security": [
{
"apiKeyHeader": []
},
{
"apiKeyQuery": []
}
]
}