{"uid":"cap_EZx3dhqPD48RY-_XiN8dH","slug":"flashscore-match-list-by-sport-and-day-b48c0f06","name":"Flashscore Match List by Sport and Day","description":"Flashscore match list for one sport and day (7 days back to 7 ahead): every match with Flashscore ID, competition (country: league), start time, home/away team, current or final score and state (scheduled, live with period, finished, after extra time/penalties, postponed, cancelled). Football, tennis, basketball, hockey, American football, baseball, handball, volleyball. Read from the feed the Flashscore web page loads.","url":"https://api.fadeandco.workers.dev/api/dev/flashscore?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":["sport"],"properties":{"day":{"type":"string","description":"Day offset from today (UTC): -7 to 7 (default 0)"},"team":{"type":"string","description":"Only matches with a team name containing this text"},"limit":{"type":"string","description":"Matches, 1 to 200 (default 50)"},"sport":{"type":"string","description":"football, tennis, basketball, hockey, american-football, baseball, handball, volleyball"},"league":{"type":"string","description":"Only competitions whose name contains this text, e.g. 'ENGLAND: Premier League'"},"status":{"type":"string","description":"all (default), live, finished or scheduled"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"day":-1,"sport":"football","source":"https://www.flashscore.com/","status":"finished","matches":191,"results":[{"id":"MRBhhXfn","url":"https://www.flashscore.com/match/MRBhhXfn/","away":"Sierra Leone U20","home":"Senegal U20","start":"2026-10-22T16:00:00.000Z","state":"finished","detail":null,"country":"Africa","awayScore":0,"homeScore":0,"competition":"AFRICA: Africa Cup of Nations U20 - Qualification"},{"id":"UiF0jBPb","url":"https://www.flashscore.com/match/UiF0jBPb/","away":"Mauritania U20","home":"Guinea-Bissau U20","start":"2026-10-22T19:00:00.000Z","state":"finished","detail":"cancelled","country":"Africa","awayScore":null,"homeScore":null,"competition":"AFRICA: Africa Cup of Nations U20 - Qualification"}],"checkedAt":"2026-10-23T09:35:25.418Z"}},"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_8OofLr1bV06viMhtGdeiS","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 every match for a given sport and day (±7 days) with Flashscore IDs, competition, teams, scores, and match state scraped from Flashscore's live feed.","exampleAgentPrompt":"Pull all of today's football matches from Flashscore — I want the full list with team names, scores, competition, and whether each game is live, finished, or scheduled.","exampleUseCases":[{"title":"Live match monitoring during game day","prompt":"Show me all the football matches that are currently live right now on Flashscore, with their current scores and which period they're in."},{"title":"Yesterday's tennis results by competition","prompt":"Get me all the finished tennis matches from yesterday on Flashscore, and filter it down to only competitions with 'ATP' in the name."},{"title":"Upcoming basketball schedule for tomorrow","prompt":"What basketball games are scheduled for tomorrow on Flashscore? Give me the full list with start times, teams, and competition names."}],"resultDescription":"A JSON object containing the queried sport, day offset, source URL, applied status filter, total match count, a checkedAt timestamp, and an array of match objects each with: Flashscore match ID, direct match URL, home and away team names, scheduled start time (ISO 8601 UTC), current match state (scheduled/live/finished/cancelled/postponed), state detail (e.g. period, after extra time), home and away scores, and competition string (country: league name).","failureModes":["Missing required 'sport' query parameter returns an error","Invalid sport value (not in the allowed enum) returns an error or empty results","Day offset outside -7 to 7 range may return an error or be clamped","Flashscore upstream feed unavailable causes scrape failure","Network timeout from the Cloudflare Worker to Flashscore source","Matches with cancelled state may have null scores"],"whenToPreferThis":"Choose this endpoint when you need comprehensive match listings for a specific sport and day sourced directly from Flashscore's live feed, including Flashscore match IDs for deep-linking. Prefer it over ESPN-based endpoints when covering sports or leagues not well-represented on ESPN (e.g. handball, volleyball, European football leagues). Best when you need match state granularity (live period, after extra time, penalties) or want to filter by team or league name across a wide international coverage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:44:22.426Z","isFirstParty":false,"canonicalSlug":"flashscore-match-list-by-sport-and-day-b48c0f06"}