Base URL and authentication
https://dynastyrewired.com/api/developer/v1Send your token in the Authorization header on every request. Create, replace or revoke it at Account → API access.
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 path | Returns |
|---|---|
GET /leagues | Leagues 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}/schedule | Weeks, games, scores and team records/standings |
GET /leagues/{league}/seasons/{season}/box-scores | Accepted 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}/rankings | Media, coaches and playoff polls by week |
GET /leagues/{league}/seasons/{season}/postseason | Playoff bracket and national championships |
GET /leagues/{league}/seasons/{season}/recruiting | Recruit pool and team class rankings |
GET /leagues/{league}/seasons/{season}/coaches | User head coaches and coordinators, active and departed |
GET /leagues/{league}/seasons/{season}/awards | Season award winners |
GET /leagues/{league}/seasons/{season}/rosters | Roster 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}/webhook | Owners only: the league webhook’s status (never its secret) |
POST /leagues/{league}/webhook/test | Owners 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.
{
"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
200with empty lists and astatesuch aspendingorunavailable.
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.
GET /leagues/cfb27-815166/seasons/2028/box-scores?limit=20
→ {"data": {"games": [ … ], "next": "2741"}}
GET /leagues/cfb27-815166/seasons/2028/box-scores?after=2741Errors
{"error": {"code": "SUBSCRIPTION_REQUIRED", "message": "This league's free trial has ended. …", "requestId": "4c1e…"}}| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_REQUEST | A query parameter is not allowed or out of range |
| 401 | UNAUTHORIZED | The token is missing, malformed, replaced or revoked |
| 402 | SUBSCRIPTION_REQUIRED | The league’s free trial has ended; the owner can subscribe to resume |
| 403 | OWNER_ONLY | Only the league owner can use this webhook endpoint |
| 404 | NOT_FOUND | Unknown endpoint, league, game or school, or a league you cannot read |
| 409 | NOT_CONFIGURED | The league has no webhook yet |
| 429 | RATE_LIMITED | Over the per-minute or daily limit (wait for Retry-After), or under 10 seconds between webhook tests |
| 502 | DELIVERY_FAILED | The webhook test reached your server, which did not answer 2xx |
| 503 | UNAVAILABLE | Temporarily 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-RemainingandX-RateLimit-Reset(Unix seconds when the daily count resets). Over a limit, the API answers429 RATE_LIMITEDwith aRetry-Afterheader 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
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}`);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"])