Description

Get a paginated list of all teams. This endpoint will return only active teams, so if a team got relegated between seasons, that team will no longer be active for that league.

Team IDs are unique per league, this means that the same team can have different IDs across leagues. For example, Manchester City FC has the following IDs:

578E2130DC1B : UEFA - Champions League
E69E55FFCF65 : England - Premier League

base_id provides a way to link the same team across leagues, for some sports like tennis where we use different providers across leagues this might not be 100% reliable.

If a team is no longer active but you want to get information about it, you can pass in the id to this endpoint and it will return data for inactive teams.

Specific Parameter Information

For a full list of parameters, scroll to the bottom of this page.

You must pass at least one of the following (sport, league, id).

sport

The sport you want to get fixtures for. You can pass the id or the name.

league

The league you want to get fixtures for. You can pass the id or the name.

id

The id of the team you want information for.

include_statsperform_id

Specify this parameter if you want the StatsPerform IDs to be included as part of the response. If this is enabled, you will see it populated in the source_ids field of the Fixture entry:

"source_ids": {
    "statsperform_id": "a2nwp4zx1mzcmk2e4dtcw5h5g"
}

Example Responses

ONLY USED TO SHOW AN EXAMPLE JSON FORMAT, DATA CAN BE DIFFERENT FROM ACTUAL RESPONSE

NFL

URL: https://api.opticodds.com/api/v3/teams?league=NFL

{
  "data": [
    {
      "id": "AF456B375E7E",
      "name": "Arizona Cardinals",
      "numerical_id": null,
      "is_active": true,
      "city": "Arizona",
      "mascot": "Cardinals",
      "nickname": "Cardinals",
      "abbreviation": "ARI",
      "division": "West",
      "conference": "NFC",
      "base_id": 81,
      "logo": "https://cdn.opticodds.com/team-logos/football/81.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football",
        "numerical_id": 9
      },
      "league": {
        "id": "nfl",
        "name": "NFL",
        "numerical_id": 367
      }
    },
    {
      "id": "348C1EE88C42",
      "name": "Atlanta Falcons",
      "numerical_id": null,
      "is_active": true,
      "city": "Atlanta",
      "mascot": "Falcons",
      "nickname": "Falcons",
      "abbreviation": "ATL",
      "division": "South",
      "conference": "NFC",
      "base_id": 82,
      "logo": "https://cdn.opticodds.com/team-logos/football/82.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football",
        "numerical_id": 9
      },
      "league": {
        "id": "nfl",
        "name": "NFL",
        "numerical_id": 367
      }
    },
    {
      "id": "766A226BC204",
      "name": "Baltimore Ravens",
      "numerical_id": null,
      "is_active": true,
      "city": "Baltimore",
      "mascot": "Ravens",
      "nickname": "Ravens",
      "abbreviation": "BAL",
      "division": "North",
      "conference": "AFC",
      "base_id": 83,
      "logo": "https://cdn.opticodds.com/team-logos/football/83.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football",
        "numerical_id": 9
      },
      "league": {
        "id": "nfl",
        "name": "NFL",
        "numerical_id": 367
      }
    },
    ...
  ]
}