# ESPN College Football Scoreboard

> ESPN College Football Scoreboard 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 college football game for a given date from ESPN, including teams, scores, game status, and venue.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/espn-college-football?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-college-football-scoreboard-f5006606
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zLVZttE_TfxRJvdNG7ncD

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-college-football-scoreboard-f5006606
```

Example prompt: What were all the college football scores from last Saturday, October 18th? I want to see every game with the final score and venue.

## When to prefer this

Use this endpoint when you need a complete list of all college football games for a specific date including live scores, final results, and scheduled matchups. It aggregates ESPN's official scoreboard data in a clean structured format. Prefer this over general sports APIs when you specifically need NCAA college football coverage with venue details. Not suitable for NFL, other sports, or detailed game statistics beyond score and status.

## Known failure modes

- Invalid date format returns an error or unexpected result
- Dates far in the future return empty list (no games scheduled yet)
- ESPN upstream API outage may cause fetch failure
- Days with no scheduled games return count:0 and empty games array
- Very old historical dates may not be available from ESPN's scoreboard API

## How this service works

ESPN college football scoreboard for one date: every game with home and away team, score, status (scheduled, live, final) and stadium, from ESPN's public site JSON. Times are UTC; days with no games return an empty list.

## Output

A JSON object containing the queried date, a count of games found, and an array of game objects each with a unique game ID, home team (name, abbreviation, score), away team (name, abbreviation, score), combined game name, venue name, game state (pre/in/post), human-readable status (Scheduled/In Progress/Final), and UTC start time. Also includes the ESPN source URL used and a checkedAt timestamp. Returns an empty games list for dates with no games.

## 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-10-17",
  "count": 52,
  "games": [
   {
    "id": "401856719",
    "away": {
     "name": "Auburn Tigers",
     "score": 27,
     "abbreviation": "AUB"
    },
    "home": {
     "name": "Georgia Bulldogs",
     "score": 24,
     "abbreviation": "UGA"
    },
    "name": "Auburn Tigers at Georgia Bulldogs",
    "state": "post",
    "venue": "Sanford Stadium",
    "status": "Final",
    "startUtc": "2026-10-17T19:30Z"
   },
   {
    "id": "401856809",
    "away": {
     "name": "Notre Dame Fighting Irish",
     "score": 24,
     "abbreviation": "ND"
    },
    "home": {
     "name": "BYU Cougars",
     "score": 28,
     "abbreviation": "BYU"
    },
    "name": "Notre Dame Fighting Irish at BYU Cougars",
    "state": "post",
    "venue": "LaVell Edwards Stadium",
    "status": "Final",
    "startUtc": "2026-10-17T23:30Z"
   }
  ],
  "source": "https://site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard?dates=20261017",
  "checkedAt": "2026-10-23T09:35:52.357Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/espn-college-football-scoreboard-f5006606/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)
