Your league. Your legacy.

College Football 27 Dynasty REST API Reference

Read-only JSON over HTTPS for College Football 27 dynasties, online and offline. Every request needs your personal token.

Base URL and authentication

Base URL
https://dynastyrewired.com/api/developer/v1

Send your token in the Authorization header on every request. Create, replace or revoke it at Account → API access.

http
Authorization: Bearer drk_…
  • Each account has one token, and it works for all of your leagues. Creating a new token replaces the old one immediately.
  • Tokens start with drk_. Dynasty Rewired stores only a fingerprint, so a lost token cannot be shown again: create a new one.
  • Call the API from a server, script or bot. Browsers cannot call it directly, which keeps your token out of web pages.

Leagues and seasons

A league’s id is the last part of its page address: https://dynastyrewired.com/leagues/cfb27-815166 is league cfb27-815166. List yours with GET /leagues.

Seasons are four-digit years such as 2028. Use current for the league’s current season. GET /leagues/{league} lists every season with saved data.

Endpoints

Method and pathReturns
GET /leaguesLeagues your token can read, with your role and each league’s access
GET /leagues/{league}League summary: seasons, current stage, tracking state and available datasets
GET /leagues/{league}/seasons/{season}/scheduleWeeks, games, scores and team records/standings
GET /leagues/{league}/seasons/{season}/box-scoresAccepted box scores, 20 per page (after, limit)
GET /leagues/{league}/seasons/{season}/box-scores/{gameId}One game’s box score
GET /leagues/{league}/seasons/{season}/rankingsMedia, coaches and playoff polls by week
GET /leagues/{league}/seasons/{season}/postseasonPlayoff bracket and national championships
GET /leagues/{league}/seasons/{season}/recruitingRecruit pool and team class rankings
GET /leagues/{league}/seasons/{season}/coachesUser head coaches and coordinators, active and departed
GET /leagues/{league}/seasons/{season}/awardsSeason award winners
GET /leagues/{league}/seasons/{season}/rostersRoster captures (runs) and which schools each captured
GET /leagues/{league}/seasons/{season}/rosters/{teamId}One school’s players, ratings and abilities (run optional)
GET /leagues/{league}/webhookOwners only: the league webhook’s status (never its secret)
POST /leagues/{league}/webhook/testOwners only: send the static test delivery to the webhook

Without run, a school’s roster comes from the newest roster capture that includes it. Field-by-field contents are in the data reference.

Responses

League requests return an envelope. data holds the dataset; its shape is in the data reference.

json
{
  "league": {"id": "cfb27-815166", "name": "TeamCrafters", "url": "https://dynastyrewired.com/leagues/cfb27-815166"},
  "season": 2028,
  "dataset": "schedule",
  "data": { "state": "available", "weeks": [ … ], "teams": [ … ] }
}
  • Times are Unix epoch milliseconds (UTC), such as capturedAt: 1793000000000.
  • IDs (teamId, gameId, playerId, recruitId) are strings.
  • Football values are kept exactly as EA sent them. Names, records and codes are never rewritten, and a value we did not capture is null, not zero.
  • New fields can appear at any time. Ignore fields you do not use; existing fields keep their meaning within v1.
  • A dataset with nothing saved yet still answers 200 with empty lists and a state such as pending or unavailable.

Box score pages

Box scores come 20 at a time in gameId order. When next is not null, pass it as after to read the next page.

http
GET /leagues/cfb27-815166/seasons/2028/box-scores?limit=20
→ {"data": {"games": [ … ], "next": "2741"}}
GET /leagues/cfb27-815166/seasons/2028/box-scores?after=2741

Errors

json
{"error": {"code": "SUBSCRIPTION_REQUIRED", "message": "This league's free trial has ended. …", "requestId": "4c1e…"}}
StatusCodeMeaning
400INVALID_REQUESTA query parameter is not allowed or out of range
401UNAUTHORIZEDThe token is missing, malformed, replaced or revoked
402SUBSCRIPTION_REQUIREDThe league’s free trial has ended; the owner can subscribe to resume
403OWNER_ONLYOnly the league owner can use this webhook endpoint
404NOT_FOUNDUnknown endpoint, league, game or school, or a league you cannot read
409NOT_CONFIGUREDThe league has no webhook yet
429RATE_LIMITEDOver the per-minute or daily limit (wait for Retry-After), or under 10 seconds between webhook tests
502DELIVERY_FAILEDThe webhook test reached your server, which did not answer 2xx
503UNAVAILABLETemporarily unavailable; retry with backoff

Include the requestId (also in the X-Request-Id header) when you ask for help.

Rate limits and polling

  • Up to 60 requests a minute and 2,000 requests a day per token. The daily count resets at midnight UTC, and replacing your token does not reset it.
  • Every authorized response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (Unix seconds when the daily count resets). Over a limit, the API answers 429 RATE_LIMITED with a Retry-After header in seconds.
  • 2,000 requests cover a full backfill of five seasons (season documents, every box score page and every school roster, about 1,000 requests) with room to spare. Your daily count appears under Account → API access.
  • League data changes only when the tracker saves a new capture, usually right after the league advances. Polling more often than every five minutes gains nothing.
  • For change notifications use a webhook instead of polling.

Examples

JavaScript (Node 18+)
const base = "https://dynastyrewired.com/api/developer/v1";
const headers = {Authorization: `Bearer ${process.env.DR_API_TOKEN}`};
const get = async path => {
  const response = await fetch(base + path, {headers});
  if (!response.ok) throw new Error((await response.json()).error.message);
  return response.json();
};
const {data: leagues} = await get("/leagues");
const {data: schedule} = await get(`/leagues/${leagues[0].id}/seasons/current/schedule`);
for (const week of schedule.weeks)
  for (const game of week.games.filter(g => g.status === "final"))
    console.log(week.label, `${game.awayName} ${game.awayScore} at ${game.homeName} ${game.homeScore}`);
Python
import os, requests
base = "https://dynastyrewired.com/api/developer/v1"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['DR_API_TOKEN']}"

def box_scores(league, season):
    after = None
    while True:
        params = {"after": after} if after else {}
        page = session.get(f"{base}/leagues/{league}/seasons/{season}/box-scores", params=params).json()["data"]
        yield from page["games"]
        if not page["next"]:
            return
        after = page["next"]

for game in box_scores("cfb27-815166", "current"):
    print(game["gameId"], game["game"]["awayName"], "at", game["game"]["homeName"])