Your league. Your legacy.

College Football 27 Dynasty Data Reference

The fields in each dataset’s data, shared by the REST API and webhook deliveries.

Conventions

  • Times are Unix epoch milliseconds (UTC). IDs are strings.
  • Values are stored as EA sent them; null means not captured.
  • userControlled marks a school coached by a human league member. true and false are captured facts; null means unknown.
  • state and reviewRequired describe how complete a capture is. review_required or action_required means a capture is held for review and may change.

Stage

Many documents name the league stage (preseason, a regular-season week, bowls, offseason) a capture belongs to:

FieldTypeMeaning
keystringStable identifier of the stage
labelstringDisplay label, such as "Week 4"
yearnumberSeason year
phasestringpreseason, season, bowl, championship, offseason or unknown
weeknumber | nullWeek number within the phase, when it has one

Leagues

GET /leagues returns a list of these; GET /leagues/{league} adds the summary fields below.

FieldTypeMeaning
idstringLeague ID, such as cfb27-815166
namestringLeague name
urlstringLeague page on Dynasty Rewired
rolestringowner, viewer (private access) or follower (a public or unlisted league it follows)
visibilitystringpublic, unlisted (anyone with the link reads it; never listed or indexed) or private
trackingStatestringactive, setup, paused_client, paused_auth, reinvite_required, archiving, archived or restart_pending
currentSeasonnumber | nullThe league’s current season year
lastCaptureAtnumber | nullTime of the last accepted capture
accessstringactive, trial, or subscription_required (API refuses the league with 402)
seasonsnumber[]Summary only: seasons with saved data, newest first
stageStage | nullSummary only: the league’s current stage
stageStatestring | nullSummary only: stable, confirming, review_required or access_lost
stageObservedAtnumber | nullSummary only: when that stage was observed
datasetsstring[]Summary only: the dataset names

Schedule

FieldTypeMeaning
statestringavailable, pending, failed, unavailable or action_required
reviewRequiredbooleanA result conflict is held for review
currentStageStage | nullStage the schedule was last captured at
currentWeekIdstring | nullThe current week’s id
capturedAtnumber | nullLatest schedule capture
weeksWeek[]Every saved week, in order
teamsTeam[]Latest team records and standings
teamsCapturedAtnumber | nullWhen teams was captured

Week

FieldTypeMeaning
idstringSchedule period ID
labelstringDisplay label, such as "Week 4" or "Bowl Week 1"
capturedAtnumberWhen this week was captured
gamesGame[]The week’s games
recordsobject[]{teamId, record, source} as of this week; source is captured or results (derived from saved finals)

Game

FieldTypeMeaning
gameIdstringGame ID, also used by box scores
periodIdnumberThe week (schedule period) it belongs to
awayTeamId, homeTeamIdstring | nullSchool IDs
awayName, homeNamestringSchool names as captured
awayUserControlled, homeUserControlledbooleanA league member coaches that school
statusstringscheduled or final
awayScore, homeScorenumber | nullFinal scores; null until final
timesPlayednumberHow many times the game was played, as EA counts it; absent in weeks saved before it was captured

Team

FieldTypeMeaning
teamIdstringSchool ID
namestringSchool name
conferencestringConference
recordstringOverall record, such as "7-2"
conferenceRecordstringConference record
standingnumber | nullConference standing
userControlledbooleanA league member coaches this school
overall, offense, defensenumberTeam ratings, when captured
prestigeStarsnumber | nullPrestige in stars (0–5, half steps); prestigeRaw is EA’s code
wins, losses, conferenceWins, conferenceLossesnumber | nullCounts, when captured
gameplayTeamId, logoIdstringEA school and logo identifiers

Box scores

FieldTypeMeaning
gameIdstringGame ID
periodIdnumberWeek (schedule period)
capturedAtnumberWhen the box score was captured
gameGameThe game, as in the schedule
away, homeobjectTeam stats: code → number, or null for a code the source could not supply (glossary below)
playersobject[]{playerId, basePlayerId, teamId, name, position, jersey, stats}; stats is code → number, or null for a code the source could not supply
periodScoresCompletefalsePresent only when the quarter scores do not add up to the final score

A box score is saved once, after the game is final, and does not change afterwards. Boxes from the tracker carry a number for every code; a box read from a save file by the offline sync app carries null for the codes a save does not record (passer rating, total plays and a few others), and season totals treat those as absent.

Team stat codes

CodeMeaning
COMPCompletions
FDFGCaptured as sent; not yet labeled on the site
FRTHFourth-down conversions
FTHDFourth-down attempts
FUMBFumbles lost
INTCInterceptions thrown
KRYDKick return yards
OFFDFirst downs
OFPYPassing yards
OFRYRushing yards
OFTDRushing touchdowns
OFYDTotal offense (yards)
ORUSRush attempts
OYPPYards per play
PAVGPunt average
PLAYTotal plays
PNLTPenalties
PNTYPenalty yards
PRYDPunt return yards
PSATPass attempts
PSSCTime of possession (seconds)
PSTDPassing touchdowns
RDTDCaptured as sent; not yet labeled on the site
REDPCaptured as sent; not yet labeled on the site
SCORFinal score
SCR1Points in the 1st quarter
SCR2Points in the 2nd quarter
SCR3Points in the 3rd quarter
SCR4Points in the 4th quarter
SCROOvertime points
THDDThird-down attempts
THRDThird-down conversions
TPUNPunts
TURNTurnovers
TWOPCaptured as sent; not yet labeled on the site
TWPACaptured as sent; not yet labeled on the site
YARDCaptured as sent; not yet labeled on the site
YPPAYards per pass
YPRUYards per rush

Player stat codes

CodeMeaning
BKSASacks allowed
BLKPPancake blocks
PAVGPunt average
PDAACaptured as sent; not yet labeled on the site
PDAYCaptured as sent; not yet labeled on the site
PDBKCaptured as sent; not yet labeled on the site
PDCACaptured as sent; not yet labeled on the site
PDDTDefensive touchdowns
PDFFForced fumbles
PDFRFumble recoveries
PDFYCaptured as sent; not yet labeled on the site
PDITInterceptions
PDPDPass deflections
PDRACaptured as sent; not yet labeled on the site
PDRLCaptured as sent; not yet labeled on the site
PDRYCaptured as sent; not yet labeled on the site
PDSYCaptured as sent; not yet labeled on the site
PDTAAssisted tackles
PDTSSolo tackles
PFAYCaptured as sent; not yet labeled on the site
PFFACaptured as sent; not yet labeled on the site
PFFMCaptured as sent; not yet labeled on the site
PFGAattempted
PFGBCaptured as sent; not yet labeled on the site
PFGLLongest field goal
PFGMField goals made
PFGPField goal percentage
PFMYCaptured as sent; not yet labeled on the site
PGDPCaptured as sent; not yet labeled on the site
PKAVKick return average
PKKOCaptured as sent; not yet labeled on the site
PKOTCaptured as sent; not yet labeled on the site
PKRAKick returns
PKRLLongest kick return
PKRTKick return touchdowns
PKRYKick return yards
PKXAattempted
PKXBCaptured as sent; not yet labeled on the site
PKXMExtra points made
PKXPCaptured as sent; not yet labeled on the site
PPACYards per completion
PPAVPunt return average
PPBKCaptured as sent; not yet labeled on the site
PPCPCaptured as sent; not yet labeled on the site
PPDTPunts downed inside 20
PPLOLongest punt
PPNANet punt average
PPNTPunts
PPNYCaptured as sent; not yet labeled on the site
PPRAPunt returns
PPRLLongest punt return
PPRTPunt return touchdowns
PPRYPunt return yards
PPTBTouchbacks
PPYDPunt yards
PRACCaptured as sent; not yet labeled on the site
PRAVYards per reception
PRCPCaptured as sent; not yet labeled on the site
PRDPDropped passes
PRLRLongest reception
PRRTReceptions
PRTDReceiving touchdowns
PRYDReceiving yards
PSAFCaptured as sent; not yet labeled on the site
PSBKCaptured as sent; not yet labeled on the site
PSDSSacks
PSPAattempts
PSPCCompletions
PSPIInterceptions thrown
PSPLLongest pass
PSPRCaptured as sent; not yet labeled on the site
PSPSTimes sacked
PSPTPassing touchdowns
PSPYPassing yards
PSRACarries
PSRFRushing fumbles
PSRLLongest run
PSRTRushing touchdowns
PSRVYards per carry
PSRYRushing yards
PSTTTotal tackles
PSTYCaptured as sent; not yet labeled on the site
PTAYCaptured as sent; not yet labeled on the site
PTFLTackles for loss
PTHACaptured as sent; not yet labeled on the site
PTHMCaptured as sent; not yet labeled on the site
PTMYCaptured as sent; not yet labeled on the site
PYAVCaptured as sent; not yet labeled on the site

Rankings

FieldTypeMeaning
currentStageStage | nullLeague stage when read
reviewRequiredbooleanA poll is held for review
weeksobject[]{stage, polls} for each captured week

Poll

FieldTypeMeaning
pollstringmedia, coaches or playoff
statestringavailable, not_released or failed
capturedAtnumberCapture time
rowsobject[]{teamId, school, rank, record, previousRank, previousState, userControlled}; previousState is ranked, unranked or unknown
receivingVotesobject[] | null{school, votes} from the poll footer
votesCapturedAtnumber | nullWhen the votes were captured

Postseason

FieldTypeMeaning
statestringavailable, pending, missing or review_required
capturedAtnumber | nullBracket capture time
slotsobject[]{slot, gameId, awaySeed, homeSeed, bowl, stadium, game}; game is the matching schedule Game or null
championshipsobject[]{year, capturedAt, reviewRequired, champion, runnerUp, championTeamId, runnerUpTeamId, championUserControlled, runnerUpUserControlled, championScore, runnerUpScore, coach, gameId}

Recruiting

FieldTypeMeaning
reviewRequiredbooleanA capture is held for review
capturesobject[]{dataset, stage, classYear, state, finalized, capturedAt, recruits, classes}

all_recruits captures fill recruits (the season’s recruit pool, captured once a season); top_classes captures fill classes (team class rankings, captured weekly); transfer_portal captures fill portal (the transfer portal, captured once a season during the Offseason Recruiting weeks; each entry names its player by the playerId the rosters dataset uses, with the portal rank, status, stars, offers and target schools).

Recruit

FieldTypeMeaning
recruitIdstringRecruit ID
namestringName
ranknumber | nullNational rank
starsnumberStar rating
positionstring | nullPosition
hometown, statestring | nullHometown and state
height, weightnumber | nullInches and pounds
stateRank, positionRanknumber | nullRanks within state and position
pipeline, archetypestring | nullRecruiting pipeline and player archetype
positionCode, stateCode, pipelineCode, archetypeCodenumberEA’s raw code, present when the site has no label for it

Class

FieldTypeMeaning
teamId, schoolstringSchool
ranknumberClass rank
commitsnumberCommitted recruits
pointsnumber or nullClass points (null for an offline league: its save keeps the rank but no points)
five, four, three, two, onenumberCommits by star rating
userControlledbooleanA league member coaches this school

Coaches

FieldTypeMeaning
statestringavailable, pending or review_required
capturedAtnumber | nullLatest coach capture
capturedStagestring | nullIts stage label
active, retiredCoach[]User-controlled coaches still in the league, and those who left
rankingsobject | null{poll, teams: [{teamId, rank}]} from the same capture

Coach

FieldTypeMeaning
identitystringStable coach identity
namestringCoach name
teamId, schoolstringCurrent or last school
rolestringHC, OC or DC
wins, losses, playoffWins, playoffLossesnumber | nullCareer record as captured
firstSeen, lastSeenobject{at, year, stage} appearances
departedobject | nullWhen the coach left
schoolsobject[]{teamId, school, firstSeen, lastSeen} for each school coached

Awards

FieldTypeMeaning
statestringpending, available, partial, missing, unknown or review_required
capturedAtnumber | nullCapture time
expectednumberAwards expected for the season
conflictsnumberConflicting captures held for review
winnersobject[]Award winners

Winner

FieldTypeMeaning
awardTypenumberEA award ID
awardstringAward name
winnerstringPlayer or coach name
recipientIdstring | nullEA recipient ID
recipientKindstringplayer or coach_role
teamId, schoolstringSchool
userControlledboolean | nullA league member coached the school
positionstringPosition, when captured
capturedAtnumberCapture time

Rosters

A roster capture (a run) reads every school at one stage. GET …/rosters lists runs; GET …/rosters/{teamId} and webhook deliveries carry school rosters.

Run

FieldTypeMeaning
idstringRun ID
stageStageStage it captured
startedAtnumberStart time
statestringrunning, complete, failed or stage_changed
schoolsobject[]{teamId, name, capturedAt}; capturedAt is null until that school is saved

School roster

FieldTypeMeaning
runIdstringThe run it came from
capturedAtnumberCapture time
teamobject{teamId, presentationId, gameplayTeamId, logoId, name, abbreviation, conference, userControlled, wins, losses, color}
playersPlayer[]Every player
abilitiesobject[]Owned abilities: {playerId, name, tier, tierCode, owned, slot, category, classification}

Player

FieldTypeMeaning
playerIdstringPlayer ID
teamIdstringSchool
name, firstName, lastNamestringNames as captured
positionstringPosition
positionCodenumberEA position code
yearstringClass year as captured, such as "JR"
overallnumberOverall rating
speednumber | nullSpeed
jerseynumberJersey number
agenumberAge
heightInches, weightPoundsnumberHeight and weight
ratingsobjectRating code → value (glossary below)
devTraitIdnumberDevelopment trait as EA sends it: 0 Normal, 1 Impact, 2 Star, 3 Elite. Absent in rosters captured before November 13, 2026
nilCompensationnumberCurrent NIL compensation, a whole number as EA sends it. Absent in rosters captured before November 13, 2026
skillGroupsobject[]The player's skill groups as EA sends them: {name, level, cap, maxCap, overall}, where level and cap count upgrade steps out of maxCap and overall is the group's rating. Absent in rosters captured before November 15, 2026

Rating codes

CodeRatingGroup
PSPDSpeedGeneral
PACCAccelerationGeneral
PAGIAgilityGeneral
PSTRStrengthGeneral
PAWRAwarenessGeneral
PJMPJumpingGeneral
PSTAStaminaGeneral
PINJInjuryGeneral
PTGHToughnessGeneral
PCARCarryingBall carrying
CODRChange of directionBall carrying
PBCVBall carrier visionBall carrying
PBTKBreak tackleBall carrying
PLTRTruckingBall carrying
PLSAStiff armBall carrying
PLJMJuke moveBall carrying
PLSMSpin moveBall carrying
PPBKPass blockBlocking
PPBPPass block powerBlocking
PPBFPass block finesseBlocking
PRBKRun blockBlocking
PRBPRun block powerBlocking
PRBFRun block finesseBlocking
PLIBImpact blockBlocking
PLBKLead blockBlocking
PTHPThrow powerPassing
PTHAThrow accuracyPassing
PTASShort throw accuracyPassing
PTAMMedium throw accuracyPassing
PTADDeep throw accuracyPassing
PTUPThrow under pressurePassing
PTORThrow on the runPassing
PPLAPlay actionPassing
PBSKBreak sackPassing
PTAKTackleDefense
PLHTHit powerDefense
PLPMPower movesDefense
PFMSFinesse movesDefense
PBSGBlock sheddingDefense
PLPUPursuitDefense
PLPRPlay recognitionDefense
PLMCMan coverageDefense
PLZCZone coverageDefense
PLPEPressDefense
PCTHCatchingReceiving
PLCICatch in trafficReceiving
PLSCSpectacular catchReceiving
PRRSShort route runningReceiving
PRRMMedium route runningReceiving
PRRDDeep route runningReceiving
PLRLReleaseReceiving
PKPRKick powerKicking
PKACKick accuracyKicking
PKRTKick returnKicking
LONGLong snapKicking
PLCFConfidenceAdditional ratings
PMORPersonalityAdditional ratings
PODRDurabilityAdditional ratings
POINIntangibleAdditional ratings
POPDProductionAdditional ratings
POPHPhysicalAdditional ratings
POSZSizeAdditional ratings
POVMModified overallAdditional ratings

PRSE is a running-style code, not a rating. Ratings the site has no name for are still included under their EA code.