{"uid":"cap_tEJ9-4RPjPzU6bJpw_Kx-","slug":"fanfare-api-fly-dev-cbd65c2d","name":"Fanfare NBA Game Schedule","description":"NBA game schedule for any date — matchups, scores by quarter, teams, and game status.","url":"https://fanfare-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-01-20"}}},"response":{"data":[{"id":"401705165","clock":null,"score":{"away":105,"home":110,"quarters":[{"away":27,"home":24,"quarter":1},{"away":28,"home":31,"quarter":2},{"away":28,"home":27,"quarter":3},{"away":22,"home":28,"quarter":4}]},"sport":"basketball","venue":{"city":"Charlotte","name":"Spectrum Center","state":"NC","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2025","status":"final","date_utc":"2025-01-20T17:00Z","away_team":{"id":"6","city":"Dallas","name":"Mavericks","division":null,"full_name":"Dallas Mavericks","conference":null,"abbreviation":"DAL"},"home_team":{"id":"30","city":"Charlotte","name":"Hornets","division":null,"full_name":"Charlotte Hornets","conference":null,"abbreviation":"CHA"}},{"id":"401705166","clock":null,"score":{"away":107,"home":96,"quarters":[{"away":40,"home":29,"quarter":1},{"away":17,"home":28,"quarter":2},{"away":33,"home":23,"quarter":3},{"away":17,"home":16,"quarter":4}]},"sport":"basketball","venue":{"city":"Houston","name":"Toyota Center (Houston)","state":"TX","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2025","status":"final","date_utc":"2025-01-20T19:00Z","away_team":{"id":"8","city":"Detroit","name":"Pistons","division":null,"full_name":"Detroit Pistons","conference":null,"abbreviation":"DET"},"home_team":{"id":"10","city":"Houston","name":"Rockets","division":null,"full_name":"Houston Rockets","conference":null,"abbreviation":"HOU"}},{"id":"401705167","clock":null,"score":{"away":106,"home":108,"quarters":[{"away":28,"home":21,"quarter":1},{"away":26,"home":22,"quarter":2},{"away":22,"home":28,"quarter":3},{"away":30,"home":37,"quarter":4}]},"sport":"basketball","venue":{"city":"Memphis","name":"FedExForum","state":"TN","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2025","status":"final","date_utc":"2025-01-20T19:30Z","away_team":{"id":"16","city":"Minnesota","name":"Timberwolves","division":null,"full_name":"Minnesota Timberwolves","conference":null,"abbreviation":"MIN"},"home_team":{"id":"29","city":"Memphis","name":"Grizzlies","division":null,"full_name":"Memphis Grizzlies","conference":null,"abbreviation":"MEM"}},{"id":"401705168","clock":null,"score":{"away":110,"home":119,"quarters":[{"away":27,"home":26,"quarter":1},{"away":35,"home":28,"quarter":2},{"away":27,"home":40,"quarter":3},{"away":21,"home":25,"quarter":4}]},"sport":"basketball","venue":{"city":"New York","name":"Madison Square Garden","state":"NY","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2025","status":"final","date_utc":"2025-01-20T20:00Z","away_team":{"id":"1","city":"Atlanta","name":"Hawks","division":null,"full_name":"Atlanta Hawks","conference":null,"abbreviation":"ATL"},"home_team":{"id":"18","city":"New York","name":"Knicks","division":null,"full_name":"New York Knicks","conference":null,"abbreviation":"NY"}},{"id":"401705169","clock":null,"score":{"away":92,"home":118,"quarters":[{"away":27,"home":27,"quarter":1},{"away":19,"home":32,"quarter":2},{"away":24,"home":34,"quarter":3},{"away":22,"home":25,"quarter":4}]},"sport":"basketball","venue":{"city":"Cleveland","name":"Rocket Arena","state":"OH","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2025","status":"final","date_utc":"2025-01-20T20:30Z","away_team":{"id":"21","city":"Phoenix","name":"Suns","division":null,"full_name":"Phoenix Suns","conference":null,"abbreviation":"PHX"},"home_team":{"id":"5","city":"Cleveland","name":"Cavaliers","division":null,"full_name":"Cleveland Cavaliers","conference":null,"abbreviation":"CLE"}},{"id":"401705170","clock":null,"score":{"away":125,"home":85,"quarters":[{"away":29,"home":18,"quarter":1},{"away":25,"home":21,"quarter":2},{"away":43,"home":24,"quarter":3},{"away":28,"home":22,"quarter":4}]},"sport":"basketball","venue":{"city":"San Francisco","name":"Chase Center","state":"CA","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2025","status":"final","date_utc":"2025-01-20T22:00Z","away_team":{"id":"2","city":"Boston","name":"Celtics","division":null,"full_name":"Boston Celtics","conference":null,"abbreviation":"BOS"},"home_team":{"id":"9","city":"Golden State","name":"Warriors","division":null,"full_name":"Golden State Warriors","conference":null,"abbreviation":"GS"}},{"id":"401705171","clock":null,"score":{"away":119,"home":123,"quarters":[{"away":38,"home":19,"quarter":1},{"away":31,"home":30,"quarter":2},{"away":20,"home":33,"quarter":3},{"away":21,"home":28,"quarter":4},{"away":9,"home":13,"quarter":"OT"}]},"sport":"basketball","venue":{"city":"New Orleans","name":"Smoothie King Center","state":"LA","surface":null,"roof_type":"indoor"},"league":"nba","period":5,"season":"2025","status":"final","date_utc":"2025-01-21T01:00Z","away_team":{"id":"26","city":"Utah","name":"Jazz","division":null,"full_name":"Utah Jazz","conference":null,"abbreviation":"UTAH"},"home_team":{"id":"3","city":"New Orleans","name":"Pelicans","division":null,"full_name":"New Orleans Pelicans","conference":null,"abbreviation":"NO"}},{"id":"401705177","clock":null,"score":{"away":112,"home":99,"quarters":[{"away":25,"home":18,"quarter":1},{"away":23,"home":32,"quarter":2},{"away":36,"home":16,"quarter":3},{"away":28,"home":33,"quarter":4}]},"sport":"basketball","venue":{"city":"Inglewood","name":"Intuit Dome","state":"CA","surface":null,"roof_type":"indoor"},"league":"nba","period":4,"season":"2025","status":"final","date_utc":"2025-01-21T03:30Z","away_team":{"id":"4","city":"Chicago","name":"Bulls","division":null,"full_name":"Chicago Bulls","conference":null,"abbreviation":"CHI"},"home_team":{"id":"12","city":"LA","name":"Clippers","division":null,"full_name":"LA Clippers","conference":null,"abbreviation":"LAC"}}],"sport":"basketball","errors":[],"league":"nba","warnings":[],"request_id":"ea0709c7-3090-4fc3-880c-d4fc8ac9980c","retrieved_at":"2026-05-29T04:40:03.372223+00:00"}},"exampleRequest":{"date":"2025-01-20"},"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_UQoVPWMvapxsOnSKolvfB","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 NBA game schedule for a given date, including matchups, quarter scores, teams, and game status.","exampleAgentPrompt":"What NBA games are scheduled for January 20, 2025 — show me the matchups, scores by quarter, and game status for each one.","exampleUseCases":[{"title":"Track tonight's NBA game scores","prompt":"Hey, pull up all the NBA games happening tonight and tell me how each team is doing quarter by quarter so far."},{"title":"Find NBA matchups for a specific week","prompt":"Can you show me the complete NBA schedule for next week? I want to see all the games, teams, and what the scores are if they've already played."},{"title":"Check holiday NBA game schedule","prompt":"What NBA games are on the schedule for Thanksgiving this year? Let me know the matchups, times, and if any have already finished with their final scores."}],"resultDescription":"A list of NBA games for the requested date, including home and away team names, scores broken down by quarter, and the current game status (e.g. scheduled, in-progress, final).","failureModes":["No games on the specified date returns an empty list","Invalid date format (not YYYY-MM-DD) may result in a 400 error","Future dates may return scheduled games without scores","Service unavailability on fly.dev hosting returns 5xx errors"],"whenToPreferThis":"Use this endpoint when you need NBA game schedule data for a specific date, including scores and game status. Prefer this over general sports APIs when you need structured quarter-by-quarter scoring data specific to NBA games.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:45:01.355Z","isFirstParty":false}