Developers

Data API

Three plain, unauthenticated JSON files, regenerated on every site update — the same data this site itself is built from. Free to build on; a link back to collegefootballbelt.com is appreciated but not required.

GET https://collegefootballbelt.com/api/current.json

The current holder, since when, days held, defenses, that team’s own reign number, and the next scheduled belt game (or null).

{
  "holder": "Notre Dame", "since": "2025-11-29", "days_held": 660,
  "defenses": 2, "team_reign_number": 9, "next_game": { ... } | null,
  "generated_at": "2026-01-01T00:00:00Z", "site": "https://collegefootballbelt.com"
}

GET https://collegefootballbelt.com/api/reigns.json

Every reign in belt history: team, start/end dates, who it was won from, the score, and defenses. Same shape as belt_data/lineage.json’s own reigns array.

GET https://collegefootballbelt.com/api/games.json

Every belt game ever played: date, teams, score, and outcome. Same shape as belt_data/lineage.json’s own belt_games array.

GitHub Pages doesn’t reliably send CORS headers on a custom domain, so a plain client-side fetch() from another site may get blocked by the browser. These work fine server-side (curl, a script, a bot) or from the same origin; a browser-based cross-origin widget may need a small proxy on your end.