{"uid":"cap_xa_k32Fz2LfX5OTn-Lh-g","slug":"espn-nba-scoreboard-by-date-cb989e35","name":"ESPN NBA Scoreboard by Date","description":"ESPN NBA scoreboard for one date: every game with away and home team, score, status (scheduled, live, final), venue and current period, from ESPN's public site JSON. Times are UTC. Days without games return an empty list.","url":"https://api.fadeandco.workers.dev/api/dev/espn-nba-scoreboard?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"date":{"type":"string","description":"Date YYYY-MM-DD (default: yesterday UTC)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"date":"2026-10-15","count":2,"games":[{"id":"401908945","away":{"name":"Toronto Raptors","score":120,"abbreviation":"TOR"},"home":{"name":"New York Knicks","score":122,"abbreviation":"NY"},"name":"Toronto Raptors at New York Knicks","state":"post","venue":"Madison Square Garden","period":4,"status":"Final","startUtc":"2026-10-15T23:30Z"},{"id":"401908622","away":{"name":"Oklahoma City Thunder","score":89,"abbreviation":"OKC"},"home":{"name":"Houston Rockets","score":116,"abbreviation":"HOU"},"name":"Oklahoma City Thunder at Houston Rockets","state":"post","venue":"Toyota Center (Houston)","period":4,"status":"Final","startUtc":"2026-10-16T00:30Z"}],"source":"https://site.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard?dates=20261015","checkedAt":"2026-10-23T09:35:40.323Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lYs397IhbYJ9SJzikHF9_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all NBA games for a given date with team names, scores, game status, venue, and period from ESPN's public scoreboard API.","exampleAgentPrompt":"What NBA games were played on January 15, 2025? I want to see all the scores, teams, venues, and final statuses for that day.","exampleUseCases":[{"title":"Live game status during broadcast","prompt":"What NBA games are happening right now? Tell me the current scores, which period each game is in, and the venues."},{"title":"Yesterday's final NBA scores recap","prompt":"Give me a full recap of all NBA games from yesterday — I want the final scores, home and away teams, and which arenas they played in."},{"title":"Check if a specific team played","prompt":"Did the Golden State Warriors play on March 10, 2025? If so, what was the final score and where was the game?"}],"resultDescription":"A JSON object with the queried date, a count of games, and an array of game objects each containing: game ID, away and home team names/abbreviations/scores, game name, state (pre/in/post), status label (Scheduled/In Progress/Final), venue name, current period, and start time in UTC. Returns an empty games list for dates with no NBA games.","failureModes":["Date out of range or far future: may return empty games list","Invalid date format: request may fail or default to yesterday","ESPN upstream outage: proxy may return error or stale data","Days with no scheduled NBA games return count 0 and empty array"],"whenToPreferThis":"Use this endpoint when you need structured NBA scoreboard data for a specific date — including live scores, final results, and game metadata like venue and period — without needing authentication or managing ESPN API keys. Prefer this over scraping ESPN directly or using unofficial scrapers, as it proxies ESPN's official public scoreboard JSON in a clean, agent-friendly format.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:20.532Z","isFirstParty":false,"canonicalSlug":"espn-nba-scoreboard-by-date-cb989e35"}