# Fanfare MLB Teams List

> Fanfare MLB Teams List is a paid API for AI agents from fanfare-api.fly.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns all 30 MLB teams with their IDs, city names, abbreviations, and division assignments.

## Facts

- Endpoint: GET https://fanfare-api.fly.dev/mlb/teams
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fanfare-api-fly-dev-0db2db33
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8ydXUQfjl1ox4m4z_A-f9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fanfare-api-fly-dev-0db2db33
```

Example prompt: Give me the full list of all 30 MLB teams — I need their team IDs, city names, abbreviations, and divisions so I can look up standings and schedules.

## When to prefer this

Use this endpoint as a first step when you need to resolve MLB team names or abbreviations to IDs before querying schedules, standings, or player rosters. It is the canonical team reference for the Fanfare MLB API ecosystem.

## Known failure modes

- Service unavailable (503) if fly.dev instance is sleeping or overloaded
- Payment required (402) if USDC payment header is missing or invalid
- Empty or malformed response if the upstream data source is unavailable

## How this service works

All 30 MLB teams with ID, city, abbreviation, and division. Use team IDs to query schedules, standings, and players.

## Output

A list of all 30 MLB teams, each including a team ID (used to query other endpoints), city name, team abbreviation, and division assignment.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data",
  "sport",
  "errors",
  "league",
  "warnings",
  "request_id",
  "retrieved_at"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "city",
     "name",
     "record",
     "standing",
     "full_name",
     "abbreviation",
     "league_division"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "city": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "record": {
      "type": "null"
     },
     "standing": {
      "type": "null"
     },
     "full_name": {
      "type": "string"
     },
     "abbreviation": {
      "type": "string"
     },
     "league_division": {
      "type": "string"
     }
    }
   }
  },
  "sport": {
   "type": "string"
  },
  "errors": {
   "type": "array",
   "items": {
    "type": "unknown"
   }
  },
  "league": {
   "type": "string"
  },
  "warnings": {
   "type": "array",
   "items": {
    "type": "unknown"
   }
  },
  "request_id": {
   "type": "string"
  },
  "retrieved_at": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fanfare-api-fly-dev-0db2db33/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fanfare-api.fly.dev](https://www.zero.xyz/host/fanfare-api.fly.dev/llms.txt)