Get teams (paginated)

get

https://api.odditt.com/v1/references/teams

Returns a paginated list of teams. When neither start_date nor end_date is provided, only teams whose affiliation is currently active are returned. When either date is provided, the result is filtered to teams whose affiliation overlapped the requested window — useful for looking up teams that played in a league during a past season.

Example response

{
  "page": 1,
  "page_size": 20,
  "records": [
    {
      "country_flag_unicode": "1F1E9 1F1EA",
      "country_name": "Germany",
      "external_key": "1-fc-heidenheim",
      "is_womens_team": false,
      "league_external_key": "bundesliga",
      "league_id": 60,
      "league_name": "Germany Bundesliga",
      "location_label": "Heidenheim an der Brenz",
      "name": "1. FC Heidenheim",
      "name_abbreviation": "FCH",
      "name_short": "Heidenheim",
      "primary_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/teams/9887.png",
      "sport_id": 3,
      "team_id": 9887
    },
    {
      "country_flag_unicode": "1F1E9 1F1EA",
      "country_name": "Germany",
      "external_key": "1-fc-koln",
      "is_womens_team": false,
      "league_external_key": "bundesliga",
      "league_id": 60,
      "league_name": "Germany Bundesliga",
      "location_label": "Cologne",
      "name": "1. FC Köln",
      "name_abbreviation": "KOE",
      "name_short": "Köln",
      "primary_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/teams/8859.png",
      "sport_id": 3,
      "team_id": 8859
    },
    {
      "country_flag_unicode": "1F1E9 1F1EA",
      "country_name": "Germany",
      "external_key": "1-fc-koln",
      "is_womens_team": true,
      "league_external_key": "frauen-bundesliga",
      "league_id": 61,
      "league_name": "Germany Frauen-Bundesliga",
      "location_label": "Koln",
      "name": "1. FC Köln W",
      "name_abbreviation": "COL",
      "name_short": "Köln W",
      "primary_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/teams/12542.png",
      "sport_id": 3,
      "team_id": 12542
    }
  ],
  "total_count": 2893,
  "total_pages": 145
}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Response

200OK