{"uid":"cap_JnVT3-DaP55JQzUlK9cJ6","slug":"fanfare-api-fly-dev-8b23bfd9","name":"Fanfare MLB Venues","description":"Returns MLB venue and stadium data for teams and parks.","url":"https://fanfare-api.fly.dev/mlb/venues","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"venueId":15}}},"response":{"data":{"id":"15","city":"Phoenix","name":"Chase Field","state":"AZ","country":"USA","surface":"turf","capacity":48359,"latitude":33.445302,"longitude":-112.066687,"roof_type":"retractable"},"sport":"baseball","errors":[],"league":"mlb","warnings":[],"request_id":"adc61bcb-c9ca-4c30-a8fa-6ed558c2b2d6","retrieved_at":"2026-05-29T04:26:35.943042+00:00"}},"exampleRequest":{"venueId":15},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bhcu0IUBdVmOHwFmxKKq4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns MLB ballpark details including city, state, seating capacity, and playing surface for all 30 stadiums or a specific venue by ID.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:39:47.338Z","isFirstParty":false}