Teams

Download schema

Team information and rosters.

GET

https://api.collegebasketballdata.com

/teams

Bearer

Returns team and conference information.

query Parameters

conference

string

Filters results to the specified conference abbreviation.

season

integer · int32

Returns conference membership for the specified season.

Responses

200

TeamInfo[]

TeamInfo

id

integer · int32 · required

sourceId

string · required

school

string · required

mascot

string | null · required

abbreviation

string | null · required

displayName

string | null · required

shortDisplayName

string | null · required

primaryColor

string | null · required

secondaryColor

string | null · required

currentVenueId

integer | null · int32 · required

currentVenue

string | null · required

currentCity

string | null · required

currentState

string | null · required

conferenceId

integer | null · int32 · required

conference

string | null · required

GET

https://api.collegebasketballdata.com

/teams/roster

Bearer

Returns team rosters for a season.

query Parameters

season

integer · int32 · required

The season to return.

team

string

Filters results to the specified team name.

Responses

200

TeamRoster[]

TeamRoster

teamId

integer · int32 · required

teamSourceId

string · required

team

string · required

conference

string | null · required

season

number · double · required

TeamRosterPlayer[] · required

GET/teams/roster

curl 'https://api.collegebasketballdata.com/teams/roster?season=<number>' \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "teamId": 0,
    "teamSourceId": "teamSourceId",
    "team": "team",
    "conference": "conference",
    "season": 0,
    "players": [
      {
        "id": 0,
        "sourceId": "sourceId",
        "name": "name",
        "firstName": "firstName",
        "lastName": "lastName",
        "jersey": "jersey",
        "position": "position",
        "height": 0,
        "weight": 0,
        "hometown": {
          "countyFips": "countyFips",
          "longitude": 0,
          "latitude": 0,
          "country": "country",
          "state": "state",
          "city": "city"
        },
        "dateOfBirth": "2024-08-25",
        "startSeason": 0,
        "endSeason": 0
      }
    ]
  }
]

json

application/json

Plays Conferences

College Basketball Data API

Teams

Download schema

Team information and rosters.

GET

https://api.collegebasketballdata.com

/teams

Bearer

Returns team and conference information.

query Parameters

conference

string

Filters results to the specified conference abbreviation.

season

integer · int32

Returns conference membership for the specified season.

Responses

200

TeamInfo[]

TeamInfo

id

integer · int32 · required

sourceId

string · required

school

string · required

mascot

string | null · required

abbreviation

string | null · required

displayName

string | null · required

shortDisplayName

string | null · required

primaryColor

string | null · required

secondaryColor

string | null · required

currentVenueId

integer | null · int32 · required

currentVenue

string | null · required

currentCity

string | null · required

currentState

string | null · required

conferenceId

integer | null · int32 · required

conference

string | null · required

GET

https://api.collegebasketballdata.com

/teams/roster

Bearer

Returns team rosters for a season.

query Parameters

season

integer · int32 · required

The season to return.

team

string

Filters results to the specified team name.

Responses

200

TeamRoster[]

TeamRoster

teamId

integer · int32 · required

teamSourceId

string · required

team

string · required

conference

string | null · required

season

number · double · required

TeamRosterPlayer[] · required

GET/teams/roster

curl 'https://api.collegebasketballdata.com/teams/roster?season=<number>' \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "teamId": 0,
    "teamSourceId": "teamSourceId",
    "team": "team",
    "conference": "conference",
    "season": 0,
    "players": [
      {
        "id": 0,
        "sourceId": "sourceId",
        "name": "name",
        "firstName": "firstName",
        "lastName": "lastName",
        "jersey": "jersey",
        "position": "position",
        "height": 0,
        "weight": 0,
        "hometown": {
          "countyFips": "countyFips",
          "longitude": 0,
          "latitude": 0,
          "country": "country",
          "state": "state",
          "city": "city"
        },
        "dateOfBirth": "2024-08-25",
        "startSeason": 0,
        "endSeason": 0
      }
    ]
  }
]

json

application/json

Plays Conferences