# Flashscore Match List by Sport and Day

> Flashscore Match List by Sport and Day is a paid API for AI agents from api.fadeandco.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

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.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/flashscore?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/flashscore-match-list-by-sport-and-day-b48c0f06
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EZx3dhqPD48RY-_XiN8dH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability flashscore-match-list-by-sport-and-day-b48c0f06
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/flashscore-match-list-by-sport-and-day-b48c0f06/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fadeandco.workers.dev](https://www.zero.xyz/host/api.fadeandco.workers.dev/llms.txt)