get https://api.opticodds.com/api/v3/teams
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 LeagueE69E55FFCF65: 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
}