# ESPN MLB Scoreboard by Date

> ESPN MLB Scoreboard by 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 every MLB game for a given date with teams, scores, game status, venue, and UTC start time sourced from ESPN's public scoreboard JSON.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/espn-mlb-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-mlb-scoreboard-by-date-694de69d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qADUBMvYLVlqF6tq45L3G

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-mlb-scoreboard-by-date-694de69d
```

Example prompt: What are all the MLB games and scores from June 15, 2026 — I want to see both teams, the final score, game status, and the venue for each matchup.

## When to prefer this

Use this endpoint when you need structured MLB game data for a specific date including scores, game status, and venue — especially when you want data consistent with MLB Stats API for final games but formatted in a compact, agent-friendly JSON. Prefer this over scraping ESPN directly or querying MLB Stats API when you want a single low-cost call that returns all games for a day in one response.

## Known failure modes

- No games on requested date returns count:0 and empty games array
- Invalid date format may return an error or default to yesterday
- Future dates beyond ESPN's schedule return only scheduled games with no scores
- Network timeout from ESPN's upstream API may cause a 502 or error response
- Missing date parameter defaults to yesterday UTC which may not match user's local date expectation

## How this service works

ESPN MLB scoreboard for one date: every game with away and home team, score, status (scheduled, live, final), and venue, from ESPN's public site JSON. Times are UTC. Scores match the MLB Stats API for final games.

## Output

A JSON object containing the queried date, total game count, and an array of games each with: game ID, away and home team names/abbreviations/scores, combined game name, venue, game state (pre/in/post), status label (Scheduled/In Progress/Final), and UTC start time. Also includes the ESPN source URL and the timestamp when data was fetched.

## 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)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-06-15",
  "count": 10,
  "games": [
   {
    "id": "401815765",
    "away": {
     "name": "Miami Marlins",
     "score": 0,
     "abbreviation": "MIA"
    },
    "home": {
     "name": "Philadelphia Phillies",
     "score": 7,
     "abbreviation": "PHI"
    },
    "name": "Miami Marlins at Philadelphia Phillies",
    "state": "post",
    "venue": "Citizens Bank Park",
    "status": "Final",
    "startUtc": "2026-06-15T22:40Z"
   },
   {
    "id": "401815764",
    "away": {
     "name": "Kansas City Royals",
     "score": 3,
     "abbreviation": "KC"
    },
    "home": {
     "name": "Washington Nationals",
     "score": 7,
     "abbreviation": "WSH"
    },
    "name": "Kansas City Royals at Washington Nationals",
    "state": "post",
    "venue": "Nationals Park",
    "status": "Final",
    "startUtc": "2026-06-15T22:45Z"
   }
  ],
  "source": "https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/scoreboard?dates=20260615",
  "checkedAt": "2026-10-23T09:35:25.785Z"
 }
}
```

## More

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