Skip to content

getTeams

Get a list of Teams by ID or league

GEThttps://api.sportsgameodds.com/v2/teams/

Parameters

ParameterTypeRequiredDescriptionExample
sportIDstringNo
A single sportID or comma-separated list of sportIDs to get Teams for
BASKETBALL
leagueIDstringNo
A single leagueID or comma-separated list of leagueIDs to get Teams for
NBA
teamIDstringNo
A single teamID or comma-separated list of teamIDs to get data for
BOSTON_CELTICS_NBA
limitnumberNo
The maximum number of Teams to return
25
cursorstringNo
The cursor for the request. Used to get the next group of Teams. This should be the nextCursor from the prior response.
n.1720564800000.DCtqsAt8d0GIFAvMmfzD

Response 200 OK

{
  "success": true,
  "data": [
    {
      "sportID": "BASEBALL",
      "leagueID": "MLB",
      "teamID": "CINCINNATI_REDS_MLB",
      "names": {
        "short": "CIN",
        "medium": "Reds",
        "long": "Cincinnati Reds"
      },
      "colors": {
        "primary": "#C80021",
        "secondary": "",
        "primaryContrast": "#FFFFFF",
        "secondaryContrast": ""
      },
      "standings": {
        "position": "4",
        "wins": 77,
        "losses": 85,
        "ties": 0,
        "record": "77-85",
        "played": 162
      }
    }
  ]
}

Error Responses

400Invalid params
401Invalid API key
403Inactive API key
404No teams found
429Rate limit exceeded
500Query failed