Skip to content

list_teams

1 creditStatic referencePOST /v1/list_teams

Club ids, abbreviations and colours for a season

Use it when you need club ids and abbreviations for a season before calling anything that takes a club.

Parameters

seasonnumber | stringoptional
Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest.
leagueenum: soccer | mls | laliga | seriea | bundesliga | ligue1 | ucl | championship | nwsl | ligamx | uel | uecl | eredivisie | primeira | scotland | brazil | argentinaoptional
League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.

Notes

  • Over MCP, ask for it in plain English and the client calls list_teams itself. Point any MCP client at https://mcp.strikerapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 1 credit, taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.strikerapi.com/v1/list_teams \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "season": 2025
}'

Response

json
{
  "season": 2025,
  "teams": [
    {
      "team_id": "349",
      "abbrev": "BOU",
      "name": "AFC Bournemouth",
      "display_name": "AFC Bournemouth",
      "short_name": "Bournemouth",
      "location": "AFC Bournemouth",
      "color": "f42727",
      "alt_color": "B57EDC",
      "logo": "https://strikerapi.com/logos/eL2kvdGVhbWxvZ29zL3NvY2Nlci81MDAvMzQ5LnBuZw.png",
      "text_color": "000000"
    },
    {
      "team_id": "359",
      "abbrev": "ARS",
      "name": "Arsenal",
      "display_name": "Arsenal",
      "short_name": "Arsenal",
      "location": "Arsenal",
      "color": "e20520",
      "alt_color": "003399",
      "logo": "https://strikerapi.com/logos/eL2kvdGVhbWxvZ29zL3NvY2Nlci81MDAvMzU5LnBuZw.png",
      "text_color": "ffffff"
    },
    {
      "team_id": "362",
      "abbrev": "AVL",
      "name": "Aston Villa",
      "display_name": "Aston Villa",
      "short_name": "Aston Villa",
      "location": "Aston Villa",
      "color": "660e36",
      "alt_color": "000000",
      "logo": "https://strikerapi.com/logos/eL2kvdGVhbWxvZ29zL3NvY2Nlci81MDAvMzYyLnBuZw.png",
      "text_color": "ffffff"
    }
  ],
  "count": 20
}

Response fields

seasonnumber
teams[]array
List of objects
teams[].team_idstring
teams[].abbrevstring
teams[].namestring
teams[].display_namestring
teams[].short_namestring
teams[].locationstring
teams[].colorstring
teams[].alt_colorstring
teams[].logostring
teams[].text_colorstring
countnumber

Related endpoints

Try it

500 free credits every month: 500 calls to list_teams, and no card.