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 calendar year. Default: the latest.

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",
      "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/349.png"
    },
    {
      "team_id": "359",
      "abbrev": "ARS",
      "name": "Arsenal",
      "display_name": "Arsenal",
      "short_name": "Arsenal",
      "location": "Arsenal",
      "color": "e20520",
      "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/359.png"
    },
    {
      "team_id": "362",
      "abbrev": "AVL",
      "name": "Aston Villa",
      "display_name": "Aston Villa",
      "short_name": "Aston Villa",
      "location": "Aston Villa",
      "color": "660e36",
      "logo": "https://a.espncdn.com/i/teamlogos/soccer/500/362.png"
    }
  ],
  "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[].logostring
countnumber

Related endpoints

Try it

500 credits free on signup: 500 calls to list_teams, and no card.