Your league. Your legacy.

How to Use the CFB 27 Dynasty API

Dynasty Rewired saves your College Football 27 dynasty after every advance and serves it as JSON through a read-only REST API. This guide takes you from a new token to your league’s schedule, box scores and rosters, with JavaScript and Python examples, then shows how a webhook sends each update to you.

Start free trialAPI referenceYour first league is free for 8 tracked advances or 2 weeks, whichever comes first. No card required.

Updated

What you need

  • A free Dynasty Rewired account. You sign in with Google.
  • A league on your dashboard. Your token reads leagues you own, private leagues you have been given access to and public leagues you follow. No league of your own yet? Follow a public one from Dynasties, or connect yours.
  • Node.js 18 or newer, or Python 3 with the requests package, to run the examples.

The API is read-only and costs nothing extra. It reads College Football 27 online dynasties, offline dynasties and Road to Glory careers, and each token can make 60 requests a minute and 2,000 a day.

Step 1: Create your API token

  1. Sign in and open Account → API access.
  2. Create a token and copy it right away. It starts with drk_ and is shown only once.
  3. Keep it in an environment variable, never in your code or a public repository.
Terminal
export DR_API_TOKEN="drk_…"

Each account has one token. Creating a new one replaces the old one at once, and you can revoke it on the same page.

Step 2: List your leagues

Send the token in the Authorization header. GET /leagues lists every league it can read.

Terminal
curl -H "Authorization: Bearer $DR_API_TOKEN" https://dynastyrewired.com/api/developer/v1/leagues
Example response
{
  "data": [
    {
      "id": "cfb27-815166",
      "name": "TeamCrafters",
      "url": "https://dynastyrewired.com/leagues/cfb27-815166",
      "role": "follower",
      "visibility": "public",
      "trackingState": "active",
      "currentSeason": 2028,
      "lastCaptureAt": 1793000000000,
      "access": "active"
    }
  ]
}

A league’s id is also the last part of its page address. role says how you reach it: owner, viewer (private access) or follower. Times such as lastCaptureAt are Unix milliseconds.

Step 3: Read the schedule

Every dataset belongs to a season. Use a year such as 2028, or current for the league’s current season.

JavaScript: save as schedule.mjs, run node schedule.mjs
const base = "https://dynastyrewired.com/api/developer/v1";
const headers = { Authorization: `Bearer ${process.env.DR_API_TOKEN}` };

const response = await fetch(`${base}/leagues/cfb27-815166/seasons/current/schedule`, { headers });
if (!response.ok) throw new Error((await response.json()).error.message);
const { season, data } = await response.json();

for (const week of data.weeks)
  for (const game of week.games.filter(g => g.status === "final"))
    console.log(season, week.label, `${game.awayName} ${game.awayScore} at ${game.homeName} ${game.homeScore}`);
Python
import os, requests

base = "https://dynastyrewired.com/api/developer/v1"
headers = {"Authorization": f"Bearer {os.environ['DR_API_TOKEN']}"}

response = requests.get(f"{base}/leagues/cfb27-815166/seasons/current/schedule", headers=headers)
response.raise_for_status()
body = response.json()
for week in body["data"]["weeks"]:
    for game in week["games"]:
        if game["status"] == "final":
            print(body["season"], week["label"], f'{game["awayName"]} {game["awayScore"]} at {game["homeName"]} {game["homeScore"]}')
Example response (TeamCrafters, 2028, trimmed)
{
  "league": {"id": "cfb27-815166", "name": "TeamCrafters", "url": "https://dynastyrewired.com/leagues/cfb27-815166"},
  "season": 2028,
  "dataset": "schedule",
  "data": {
    "state": "available",
    "weeks": [
      {
        "label": "Week 4",
        "games": [
          {"gameId": "829161628", "status": "final", "awayName": "Marshall", "awayScore": 28,
           "homeName": "Middle Tennessee", "homeScore": 48, "awayUserControlled": true, "homeUserControlled": true}
        ]
      }
    ],
    "teams": [ … ]
  }
}

awayUserControlled and homeUserControlled mark schools coached by people in the league, and scores stay null until a game is final. Every field is in the data reference.

Step 4: Get box scores, rosters and more

RequestReturns
GET /leagues/{league}/seasons/{season}/box-scoresBox scores with team and player stats, 20 games a page
GET /leagues/{league}/seasons/{season}/rosters/{teamId}One school’s players, ratings and abilities
GET /leagues/{league}/seasons/{season}/rankingsMedia, coaches and playoff polls by week
GET /leagues/{league}/seasons/{season}/recruitingThe recruit pool and class rankings
GET /leagues/{league}/seasons/{season}/coachesUser head coaches and coordinators
GET /leagues/{league}/seasons/{season}/awardsSeason award winners
GET /leagues/{league}/seasons/{season}/postseasonThe playoff bracket and champions

Box scores come a page at a time: when next is not null, pass it as after to read the next page. The REST API reference lists every endpoint, error and limit.

League data changes only when Dynasty Rewired saves a new capture, usually right after your league advances, so checking more often than every five minutes gains nothing.

Step 5: Get updates sent to you

Instead of checking for changes, a league owner can add a webhook. Dynasty Rewired then sends each new capture to your HTTPS server within about a minute, signed with a secret only you hold. A delivery’s data is exactly what the matching API request returns, so the same code reads both.

  1. Open your league’s settings and find Webhook.
  2. Enter your server’s https:// address and save, then copy the signing secret (whsec_…).
  3. Press Send test delivery and check that your server answered with a 2xx status.

A webhook is the easy way to keep your own copy of the league or post results to a Discord channel. Webhooks shows the delivery format and how to check the signature in Node.js and Python. For week-advance alerts alone you need no code: turn on Dynasty Rewired’s own announcements under Discord in your league’s settings.

Fix common problems

StatusWhat it meansWhat to do
401The token is missing, mistyped, replaced or revokedSend Authorization: Bearer drk_…, or create a new token
402The league’s free trial ended without a subscriptionThe owner can subscribe to resume access; see pricing
404An unknown league, season, game or school, or a league your token cannot readCheck the league id, or follow the league first
429Over 60 requests a minute or 2,000 a dayWait the number of seconds in Retry-After

Every error includes a requestId. Include it when you ask for help.

Questions

Does the API cost extra?

No. The API and webhooks come with every active league, including during its free trial. Each token can make 60 requests a minute and 2,000 a day.

Can I read a league I don’t own?

Yes, if it is on your dashboard: a public league you follow, or a private league whose owner gave you access.

Does it work for offline dynasties and Road to Glory?

Yes. Leagues synced from a Windows PC with the Offline Sync app or a save upload are read the same way. Values a save does not hold come back as null.

Which games are supported?

College Football 27. Dynasties from College Football 25 and College Football 26 are not supported.

Is Dynasty Rewired affiliated with EA SPORTS?

No. Dynasty Rewired is independent and is not affiliated with, endorsed by or sponsored by Electronic Arts or EA SPORTS. The API serves the data Dynasty Rewired saves from your league.

Ready to track your league?

Start free trialAPI referenceYour first league is free for 8 tracked advances or 2 weeks, whichever comes first. No card required.