# Fanfare MLB Venues

> Fanfare MLB Venues 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 MLB ballpark details including city, state, seating capacity, and playing surface for all 30 stadiums or a specific venue by ID.

## Facts

- Endpoint: GET https://fanfare-api.fly.dev/mlb/venues
- 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-8b23bfd9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JnVT3-DaP55JQzUlK9cJ6

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-8b23bfd9
```

Example prompt: Can you look up the details for MLB venue ID 15 — I want to know the city, state, capacity, and whether it has turf or grass?

## When to prefer this

Use this endpoint when you need structured factual data about MLB ballpark locations, capacities, or playing surfaces — ideal for sports planning apps, trivia bots, or enriching game-day content with stadium context. Prefer over manual lookup or web scraping for fast, structured responses.

## Known failure modes

- Invalid or non-existent venueId returns empty result or 404
- Network timeout from fly.dev deployment
- Payment failure via x402 protocol results in 402 response
- No query params returns full list which may be larger than expected

## How this service works

Returns MLB venue and stadium data for teams and parks.

## Output

Returns one or more MLB ballpark records containing the venue name, city, state, seating capacity, and playing surface type (e.g. natural grass or artificial turf). When no venueId is specified, all 30 MLB stadiums are returned.

## Example request

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

## 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": {
      "venueId": {
       "type": "integer",
       "description": "MLB venue ID"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fanfare-api-fly-dev-8b23bfd9/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)