# ESPN Soccer Scoreboard by League & Date

> ESPN Soccer Scoreboard by League & Date 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 match results and live scores for a given soccer league and date from ESPN's public scoreboard API, including teams, scores, status, and venue.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/espn-soccer-scoreboard?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/espn-soccer-scoreboard-by-league-date-66dd4850
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SMUPWQ200dLcUosspdk2b

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 espn-soccer-scoreboard-by-league-date-66dd4850
```

Example prompt: What were all the Premier League scores yesterday? I want to see the home and away teams, final scores, and stadiums for each match.

## When to prefer this

Use this endpoint when you need quick, structured soccer match data (scores, status, venue) for a specific league and date sourced from ESPN's public API, without needing authentication. Prefer this over scraping ESPN directly or using paid sports data APIs when ESPN's public feed suffices and the supported leagues (Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League) cover your need.

## Known failure modes

- Invalid league code returns an empty matches array or error
- Future dates with no scheduled matches return count:0 and empty matches array
- Malformed date format may return an error or fall back to default date
- ESPN upstream API unavailability causes proxy failure
- Dates far in the future may have no data yet

## How this service works

ESPN soccer scoreboard for one league and date: each match with home and away team, score, status (scheduled, live, full time) and stadium, from ESPN's public site JSON. Default league is the English Premier League (eng.1); times are UTC.

## Output

A JSON object containing the date, league code, league name, match count, and an array of matches each with home/away team names, abbreviations, scores, match state (pre/in/post), human-readable status (e.g. FT, LIVE), venue name, match start time in UTC, and the ESPN source URL. Also includes a checkedAt timestamp.

## 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": [],
     "properties": {
      "date": {
       "type": "string",
       "description": "Date YYYY-MM-DD (default: yesterday UTC)"
      },
      "league": {
       "type": "string",
       "description": "ESPN league code, e.g. eng.1, esp.1, ger.1, ita.1, fra.1, uefa.champions (default eng.1)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-10-17",
  "count": 5,
  "league": "eng.1",
  "source": "https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/scoreboard?dates=20261017",
  "matches": [
   {
    "id": "401878771",
    "away": {
     "name": "Chelsea",
     "score": 2,
     "abbreviation": "CHE"
    },
    "home": {
     "name": "Everton",
     "score": 0,
     "abbreviation": "EVE"
    },
    "name": "Chelsea at Everton",
    "state": "post",
    "venue": "Hill Dickinson Stadium",
    "status": "FT",
    "startUtc": "2026-10-17T11:30Z"
   },
   {
    "id": "401879262",
    "away": {
     "name": "Liverpool",
     "score": 2,
     "abbreviation": "LIV"
    },
    "home": {
     "name": "Brentford",
     "score": 1,
     "abbreviation": "BRE"
    },
    "name": "Liverpool at Brentford",
    "state": "post",
    "venue": "Gtech Community Stadium",
    "status": "FT",
    "startUtc": "2026-10-17T14:00Z"
   }
  ],
  "checkedAt": "2026-10-23T09:35:26.283Z",
  "league_name": "English Premier League"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/espn-soccer-scoreboard-by-league-date-66dd4850/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)