{"openapi":"3.1.0","info":{"title":"Dynasty Rewired developer API","version":"1.0.0","description":"Read-only access to College Football 27 dynasty data. Docs: https://dynastyrewired.com/developer"},"servers":[{"url":"https://dynastyrewired.com/api/developer/v1"}],"security":[{"bearerAuth":[]}],"paths":{"/leagues":{"get":{"operationId":"listLeagues","summary":"Leagues this token can read","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/League"}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}":{"get":{"operationId":"getLeague","summary":"League summary","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"data":{"$ref":"#/components/schemas/League"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/schedule":{"get":{"operationId":"getSchedule","summary":"Weeks, games, scores and standings","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"schedule"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/rankings":{"get":{"operationId":"getRankings","summary":"Polls by week","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"rankings"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/postseason":{"get":{"operationId":"getPostseason","summary":"Playoff bracket and championships","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"postseason"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/recruiting":{"get":{"operationId":"getRecruiting","summary":"Recruit pool and class rankings","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"recruiting"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/coaches":{"get":{"operationId":"getCoaches","summary":"User coaches","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"coaches"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/awards":{"get":{"operationId":"getAwards","summary":"Award winners","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"awards"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/box-scores":{"get":{"operationId":"listBoxScores","summary":"Box scores, 20 per page","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"},{"name":"after","in":"query","schema":{"type":"string"},"description":"The previous page’s `next`"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"box-scores"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/box-scores/{gameId}":{"get":{"operationId":"getBoxScore","summary":"One game’s box score","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"},{"name":"gameId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"box-scores"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/rosters":{"get":{"operationId":"listRosterRuns","summary":"Roster captures and their schools","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"rosters"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/seasons/{season}/rosters/{teamId}":{"get":{"operationId":"getRoster","summary":"One school’s roster","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"},{"name":"season","in":"path","required":true,"schema":{"type":"string","pattern":"^(\\d{4}|current)$"},"example":"current"},{"name":"teamId","in":"path","required":true,"schema":{"type":"string"}},{"name":"run","in":"query","schema":{"type":"string"},"description":"A run ID; defaults to the newest capture of the school"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["league","season","dataset","data"],"properties":{"league":{"$ref":"#/components/schemas/LeagueRef"},"season":{"type":"integer"},"dataset":{"const":"rosters"},"data":{"type":"object","additionalProperties":true,"description":"See https://dynastyrewired.com/developer/data"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/webhook":{"get":{"operationId":"getWebhook","summary":"Owner only: webhook status","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not the owner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/leagues/{league}/webhook/test":{"post":{"operationId":"testWebhook","summary":"Owner only: send the static test delivery","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","pattern":"^cfb27-[A-Za-z0-9_-]+$"},"example":"cfb27-815166"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, malformed or revoked token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"League trial ended; subscription required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not the owner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found or not readable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"No webhook","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Over 60 requests a minute or 2,000 a day per token; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Receiver did not answer 2xx","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A personal token (drk_…) from https://dynastyrewired.com/account#api-access"}},"schemas":{"LeagueRef":{"type":"object","required":["id","name","url"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"}}},"League":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"},"role":{"enum":["owner","viewer","follower"]},"visibility":{"enum":["public","unlisted","private"]},"trackingState":{"type":"string"},"currentSeason":{"type":["integer","null"]},"lastCaptureAt":{"type":["integer","null"]},"access":{"enum":["active","trial","subscription_required"]},"seasons":{"type":"array","items":{"type":"integer"}}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}}}}}}}}