{"uid":"cap_44oh2Lzc38_mZHQdhXNsl","slug":"mlb-stats-api-fly-dev-b6df15c4","name":"NBA Game Schedule","description":"NBA game schedule. Optional: date (YYYY-MM-DD).","url":"https://mlb-stats-api.fly.dev/nba/schedule","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":{"date":{"type":"string","description":"Game date (YYYY-MM-DD)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"object","required":["data","sport","errors","league","warnings","request_id","retrieved_at"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","clock","score","sport","venue","league","period","season","status","date_utc","away_team","home_team"],"properties":{"id":{"type":"string"},"clock":{"type":"null"},"score":{"type":"object","required":["away","home","quarters"],"properties":{"away":{"type":"number"},"home":{"type":"number"},"quarters":{"type":"array","items":{"type":"object","required":["away","home","quarter"],"properties":{"away":{"type":"number"},"home":{"type":"number"},"quarter":{"type":"number"}}}}}},"sport":{"type":"string"},"venue":{"type":"object","required":["city","name","state","surface","roof_type"],"properties":{"city":{"type":"string"},"name":{"type":"string"},"state":{"type":"string"},"surface":{"type":"null"},"roof_type":{"type":"string"}}},"league":{"type":"string"},"period":{"type":"number"},"season":{"type":"string"},"status":{"type":"string"},"date_utc":{"type":"string"},"away_team":{"type":"object","required":["id","city","name","division","full_name","conference","abbreviation"],"properties":{"id":{"type":"string"},"city":{"type":"string"},"name":{"type":"string"},"division":{"type":"null"},"full_name":{"type":"string"},"conference":{"type":"null"},"abbreviation":{"type":"string"}}},"home_team":{"type":"object","required":["id","city","name","division","full_name","conference","abbreviation"],"properties":{"id":{"type":"string"},"city":{"type":"string"},"name":{"type":"string"},"division":{"type":"null"},"full_name":{"type":"string"},"conference":{"type":"null"},"abbreviation":{"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"}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"date":"2025-12-25"}}},"response":{"data":[{"id":"401809238","clock":null,"score":{"away":124,"home":126,"quarters":[{"away":38,"home":23,"quarter":1},{"away":20,"home":37,"quarter":2},{"away":38,"home":24,"quarter":3},{"away":28,"home":42,"quarter":4}]},"sport":"basketball","venue":{"city":"New York","name":"Madison Square Garden","state":"NY","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2026","status":"final","date_utc":"2025-12-25T17:00Z","away_team":{"id":"5","city":"Cleveland","name":"Cavaliers","division":null,"full_name":"Cleveland Cavaliers","conference":null,"abbreviation":"CLE"},"home_team":{"id":"18","city":"New York","name":"Knicks","division":null,"full_name":"New York Knicks","conference":null,"abbreviation":"NY"}},{"id":"401809239","clock":null,"score":{"away":117,"home":102,"quarters":[{"away":41,"home":36,"quarter":1},{"away":28,"home":24,"quarter":2},{"away":26,"home":19,"quarter":3},{"away":22,"home":23,"quarter":4}]},"sport":"basketball","venue":{"city":"Oklahoma City","name":"Paycom Center","state":"OK","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2026","status":"final","date_utc":"2025-12-25T19:30Z","away_team":{"id":"24","city":"San Antonio","name":"Spurs","division":null,"full_name":"San Antonio Spurs","conference":null,"abbreviation":"SA"},"home_team":{"id":"25","city":"Oklahoma City","name":"Thunder","division":null,"full_name":"Oklahoma City Thunder","conference":null,"abbreviation":"OKC"}},{"id":"401809240","clock":null,"score":{"away":116,"home":126,"quarters":[{"away":28,"home":40,"quarter":1},{"away":30,"home":31,"quarter":2},{"away":31,"home":29,"quarter":3},{"away":27,"home":26,"quarter":4}]},"sport":"basketball","venue":{"city":"San Francisco","name":"Chase Center","state":"CA","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2026","status":"final","date_utc":"2025-12-25T22:17Z","away_team":{"id":"6","city":"Dallas","name":"Mavericks","division":null,"full_name":"Dallas Mavericks","conference":null,"abbreviation":"DAL"},"home_team":{"id":"9","city":"Golden State","name":"Warriors","division":null,"full_name":"Golden State Warriors","conference":null,"abbreviation":"GS"}},{"id":"401809241","clock":null,"score":{"away":119,"home":96,"quarters":[{"away":37,"home":25,"quarter":1},{"away":26,"home":28,"quarter":2},{"away":29,"home":21,"quarter":3},{"away":27,"home":22,"quarter":4}]},"sport":"basketball","venue":{"city":"Los Angeles","name":"crypto.com Arena","state":"CA","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2026","status":"final","date_utc":"2025-12-26T01:00Z","away_team":{"id":"10","city":"Houston","name":"Rockets","division":null,"full_name":"Houston Rockets","conference":null,"abbreviation":"HOU"},"home_team":{"id":"13","city":"Los Angeles","name":"Lakers","division":null,"full_name":"Los Angeles Lakers","conference":null,"abbreviation":"LAL"}},{"id":"401809242","clock":null,"score":{"away":138,"home":142,"quarters":[{"away":29,"home":32,"quarter":1},{"away":26,"home":25,"quarter":2},{"away":23,"home":35,"quarter":3},{"away":37,"home":23,"quarter":4},{"away":23,"home":27,"quarter":"OT"}]},"sport":"basketball","venue":{"city":"Denver","name":"Ball Arena","state":"CO","surface":null,"roof_type":"indoor"},"league":"nba","period":5,"season":"2026","status":"final","date_utc":"2025-12-26T03:30Z","away_team":{"id":"16","city":"Minnesota","name":"Timberwolves","division":null,"full_name":"Minnesota Timberwolves","conference":null,"abbreviation":"MIN"},"home_team":{"id":"7","city":"Denver","name":"Nuggets","division":null,"full_name":"Denver Nuggets","conference":null,"abbreviation":"DEN"}}],"sport":"basketball","errors":[],"league":"nba","warnings":[],"request_id":"7dd65364-4c5d-4259-8325-dc5f5799011f","retrieved_at":"2026-05-29T04:45:44.102800+00:00"}},"exampleRequest":{"date":"2025-12-25"},"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_1pcOQTWnDTYH2TgA01OUS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the NBA game schedule, optionally filtered by a specific date.","exampleAgentPrompt":"What NBA games are scheduled for December 25, 2025?","exampleUseCases":null,"resultDescription":"A list of NBA games for the requested date (or current/upcoming schedule if no date provided), including team matchups, game times, and related schedule details.","failureModes":["Invalid date format returns an error — must use YYYY-MM-DD","No games on the requested date returns an empty schedule","Date out of current season range may return empty or error","Network/server unavailability returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need NBA game schedule data for a specific date or the current schedule. Prefer this over MLB, NFL, or NHL schedule endpoints specifically for NBA basketball games. It supports optional date filtering, making it suitable for day-specific lookups or fetching the general upcoming schedule.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:21.787Z","isFirstParty":false}