Skip to content

list_teams

1 creditStatic referencePOST /v1/list_teams

Team ids, abbreviations and colours for a season

Use it when you need team ids and abbreviations for a season. Every other endpoint takes a team as either.

Parameters

seasonnumber | stringoptional
Season (a year, e.g. 2025; default: the latest).
leagueenum: mlb | ncaabaseoptional
League. Defaults to mlb. One of: mlb, ncaabase.

Notes

  • Over MCP, ask for it in plain English and the client calls list_teams itself. Point any MCP client at https://mcp.fastballapi.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.fastballapi.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": "29",
      "abbrev": "ARI",
      "name": "Diamondbacks",
      "display_name": "Arizona Diamondbacks",
      "location": "Arizona",
      "color": "aa182c",
      "logo": "https://fastballapi.com/logos/eL2kvdGVhbWxvZ29zL21sYi81MDAvYXJpLnBuZw.png"
    },
    {
      "team_id": "11",
      "abbrev": "ATH",
      "name": "Athletics",
      "display_name": "Athletics",
      "location": "Athletics",
      "color": "003831",
      "logo": "https://fastballapi.com/logos/eL2kvdGVhbWxvZ29zL21sYi81MDAvYXRoLnBuZw.png"
    },
    {
      "team_id": "15",
      "abbrev": "ATL",
      "name": "Braves",
      "display_name": "Atlanta Braves",
      "location": "Atlanta",
      "color": "0c2340",
      "logo": "https://fastballapi.com/logos/eL2kvdGVhbWxvZ29zL21sYi81MDAvYXRsLnBuZw.png"
    }
  ],
  "count": 30
}

Response fields

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

Related endpoints

Try it

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