Retrieve a list of teams based on the provided query parameters.

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

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

NFL

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

{
  "data": [
    {
      "id": "AF456B375E7E",
      "name": "Arizona Cardinals",
      "is_active": true,
      "city": "Arizona",
      "mascot": "Cardinals",
      "nickname": "Cardinals",
      "abbreviation": "ARI",
      "division": "West",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/ari.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "348C1EE88C42",
      "name": "Atlanta Falcons",
      "is_active": true,
      "city": "Atlanta",
      "mascot": "Falcons",
      "nickname": "Falcons",
      "abbreviation": "ATL",
      "division": "South",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/atl.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "766A226BC204",
      "name": "Baltimore Ravens",
      "is_active": true,
      "city": "Baltimore",
      "mascot": "Ravens",
      "nickname": "Ravens",
      "abbreviation": "BAL",
      "division": "North",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/bal.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "0787D09E47B9",
      "name": "Buffalo Bills",
      "is_active": true,
      "city": "Buffalo",
      "mascot": "Bills",
      "nickname": "Bills",
      "abbreviation": "BUF",
      "division": "East",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/buf.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "EB5E972AB475",
      "name": "Carolina Panthers",
      "is_active": true,
      "city": "Carolina",
      "mascot": "Panthers",
      "nickname": "Panthers",
      "abbreviation": "CAR",
      "division": "South",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/car.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "7108F48884ED",
      "name": "Chicago Bears",
      "is_active": true,
      "city": "Chicago",
      "mascot": "Bears",
      "nickname": "Bears",
      "abbreviation": "CHI",
      "division": "North",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/chi.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "EB3A43FF026E",
      "name": "Cincinnati Bengals",
      "is_active": true,
      "city": "Cincinnati",
      "mascot": "Bengals",
      "nickname": "Bengals",
      "abbreviation": "CIN",
      "division": "North",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/cin.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "81A1B4413577",
      "name": "Cleveland Browns",
      "is_active": true,
      "city": "Cleveland",
      "mascot": "Browns",
      "nickname": "Browns",
      "abbreviation": "CLE",
      "division": "North",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/cle.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "0BDD5205ECCB",
      "name": "Dallas Cowboys",
      "is_active": true,
      "city": "Dallas",
      "mascot": "Cowboys",
      "nickname": "Cowboys",
      "abbreviation": "DAL",
      "division": "East",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/dal.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "0DBD3AEC9A84",
      "name": "Denver Broncos",
      "is_active": true,
      "city": "Denver",
      "mascot": "Broncos",
      "nickname": "Broncos",
      "abbreviation": "DEN",
      "division": "West",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/den.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "43412DC9CDCA",
      "name": "Detroit Lions",
      "is_active": true,
      "city": "Detroit",
      "mascot": "Lions",
      "nickname": "Lions",
      "abbreviation": "DET",
      "division": "North",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/det.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "2C6CB429C60C",
      "name": "Green Bay Packers",
      "is_active": true,
      "city": "Green Bay",
      "mascot": "Packers",
      "nickname": "Packers",
      "abbreviation": "GB",
      "division": "North",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/gb.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "4DD082E9EC10",
      "name": "Houston Texans",
      "is_active": true,
      "city": "Houston",
      "mascot": "Texans",
      "nickname": "Texans",
      "abbreviation": "HOU",
      "division": "South",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/hou.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "28ABEAB98C11",
      "name": "Indianapolis Colts",
      "is_active": true,
      "city": "Indianapolis",
      "mascot": "Colts",
      "nickname": "Colts",
      "abbreviation": "IND",
      "division": "South",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/ind.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "9CCE4CA64CF2",
      "name": "Jacksonville Jaguars",
      "is_active": true,
      "city": "Jacksonville",
      "mascot": "Jaguars",
      "nickname": "Jaguars",
      "abbreviation": "JAX",
      "division": "South",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/jax.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "2D71E5BA64A5",
      "name": "Kansas City Chiefs",
      "is_active": true,
      "city": "Kansas City",
      "mascot": "Chiefs",
      "nickname": "Chiefs",
      "abbreviation": "KC",
      "division": "West",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/kc.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "A715F8199801",
      "name": "Las Vegas Raiders",
      "is_active": true,
      "city": "Las Vegas",
      "mascot": "Raiders",
      "nickname": "Raiders",
      "abbreviation": "LV",
      "division": "West",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/lv.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "A283836CDF6E",
      "name": "Los Angeles Chargers",
      "is_active": true,
      "city": "Los Angeles",
      "mascot": "Chargers",
      "nickname": "Chargers",
      "abbreviation": "LAC",
      "division": "West",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/lac.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "13AD4FDBEBA8",
      "name": "Los Angeles Rams",
      "is_active": true,
      "city": "Los Angeles",
      "mascot": "Rams",
      "nickname": "Rams",
      "abbreviation": "LAR",
      "division": "West",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/lar.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "8380A12E67FE",
      "name": "Miami Dolphins",
      "is_active": true,
      "city": "Miami",
      "mascot": "Dolphins",
      "nickname": "Dolphins",
      "abbreviation": "MIA",
      "division": "East",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/mia.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "24E4EA618C5E",
      "name": "Minnesota Vikings",
      "is_active": true,
      "city": "Minnesota",
      "mascot": "Vikings",
      "nickname": "Vikings",
      "abbreviation": "MIN",
      "division": "North",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/min.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "04E3F3D69B89",
      "name": "New England Patriots",
      "is_active": true,
      "city": "New England",
      "mascot": "Patriots",
      "nickname": "Patriots",
      "abbreviation": "NE",
      "division": "East",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/ne.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "E94C20E042D9",
      "name": "New Orleans Saints",
      "is_active": true,
      "city": "New Orleans",
      "mascot": "Saints",
      "nickname": "Saints",
      "abbreviation": "NO",
      "division": "South",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/no.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "ACC49FC634EE",
      "name": "New York Giants",
      "is_active": true,
      "city": "New York",
      "mascot": "Giants",
      "nickname": "Giants",
      "abbreviation": "NYG",
      "division": "East",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/nyg.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "032D4F9C6C55",
      "name": "New York Jets",
      "is_active": true,
      "city": "New York",
      "mascot": "Jets",
      "nickname": "Jets",
      "abbreviation": "NYJ",
      "division": "East",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/nyj.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "EDCC2866B795",
      "name": "Philadelphia Eagles",
      "is_active": true,
      "city": "Philadelphia",
      "mascot": "Eagles",
      "nickname": "Eagles",
      "abbreviation": "PHI",
      "division": "East",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/phi.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "727B3B3C78E8",
      "name": "Pittsburgh Steelers",
      "is_active": true,
      "city": "Pittsburgh",
      "mascot": "Steelers",
      "nickname": "Steelers",
      "abbreviation": "PIT",
      "division": "North",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/pit.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "132B64CEDAC4",
      "name": "San Francisco 49ers",
      "is_active": true,
      "city": "San Francisco",
      "mascot": "49ers",
      "nickname": "49ers",
      "abbreviation": "SF",
      "division": "West",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/sf.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "EFED0277C4BD",
      "name": "Seattle Seahawks",
      "is_active": true,
      "city": "Seattle",
      "mascot": "Seahawks",
      "nickname": "Seahawks",
      "abbreviation": "SEA",
      "division": "West",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/sea.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "4E7DB4C57393",
      "name": "Tampa Bay Buccaneers",
      "is_active": true,
      "city": "Tampa Bay",
      "mascot": "Buccaneers",
      "nickname": "Buccaneers",
      "abbreviation": "TB",
      "division": "South",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/tb.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "24988863B4CB",
      "name": "Tennessee Titans",
      "is_active": true,
      "city": "Tennessee",
      "mascot": "Titans",
      "nickname": "Titans",
      "abbreviation": "TEN",
      "division": "South",
      "conference": "AFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/ten.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    },
    {
      "id": "C921828AB706",
      "name": "Washington Commanders",
      "is_active": true,
      "city": "Washington",
      "mascot": "Commanders",
      "nickname": "Commanders",
      "abbreviation": "WSH",
      "division": "East",
      "conference": "NFC",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/wsh.png",
      "source_ids": {

      },
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      }
    }
  ],
  "page": 1,
  "total_pages": 1
}
Language
Authorization
Click Try It! to start a request and see the response here!