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
requestspackage, 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
- Sign in and open Account → API access.
- Create a token and copy it right away. It starts with
drk_and is shown only once. - Keep it in an environment variable, never in your code or a public repository.
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.
curl -H "Authorization: Bearer $DR_API_TOKEN" https://dynastyrewired.com/api/developer/v1/leagues{
"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.
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}`);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"]}'){
"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
| Request | Returns |
|---|---|
GET /leagues/{league}/seasons/{season}/box-scores | Box 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}/rankings | Media, coaches and playoff polls by week |
GET /leagues/{league}/seasons/{season}/recruiting | The recruit pool and class rankings |
GET /leagues/{league}/seasons/{season}/coaches | User head coaches and coordinators |
GET /leagues/{league}/seasons/{season}/awards | Season award winners |
GET /leagues/{league}/seasons/{season}/postseason | The 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.
- Open your league’s settings and find Webhook.
- Enter your server’s
https://address and save, then copy the signing secret (whsec_…). - Press Send test delivery and check that your server answered with a
2xxstatus.
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
| Status | What it means | What to do |
|---|---|---|
401 | The token is missing, mistyped, replaced or revoked | Send Authorization: Bearer drk_…, or create a new token |
402 | The league’s free trial ended without a subscription | The owner can subscribe to resume access; see pricing |
404 | An unknown league, season, game or school, or a league your token cannot read | Check the league id, or follow the league first |
429 | Over 60 requests a minute or 2,000 a day | Wait 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.
