Data Dictionary

Reference for all status codes, field values, and enumerated types used across RotoWire API responses.

Injury Status Codes

The InjuryStatus field appears on player and update objects across all injury and news endpoints.

Code	Full Name	Meaning
`OUT`	Out	Player will not play. Confirmed inactive.
`GTD`	Game-Time Decision	Status undecided; team will assess closer to game time.
`Q`	Questionable	Player is uncertain to play. Lower confidence than GTD.
`D`	Doubtful	Unlikely to play; injury is significant.
`IR`	Injured Reserve	On the official injured reserve list; ineligible to play for at least a set period.
`IR-R`	IR - Return Designee	On IR but designated for return; eligible to practice and return within a window.
`PUP`	Physically Unable to Perform	Pre-season IR designation; cannot practice or play until cleared.
`SUSP`	Suspended	Player is serving a league suspension.
`DNP`	Did Not Play	Post-game designation; player dressed but was not used.
`NA`	Not Available	Player is unavailable for non-injury reasons (personal, rest, etc.).
`ACT`	Active	Player is confirmed active and available to play.

NBA-specific: The NBAInjuryStatus field uses the official NBA designations: QUESTIONABLE, DOUBTFUL, OUT, DAY_TO_DAY. This mirrors the official NBA injury report terminology.

Update Priority Levels

The Priority field on news and injury updates indicates impact level. Use max_priority as a query parameter to filter by minimum priority.

Priority	Level	Typical Use Case
`1`	Critical	Star player ruled out; significant last-minute lineup change; major trade.
`2`	High	Starter questionable or doubtful; notable injury update with DFS/fantasy impact.
`3`	Medium	Rotation player update; minor injury news; expected return timeline.
`4`	Low	Practice participation note; depth chart adjustment; minor transaction.
`5`	Informational	General roster news; non-impactful updates.

Filtering example:

# Only return Priority 1 and 2 updates
curl "https://api.rotowire.com/Basketball/get-nba-injuries.php?key=YOUR_API_KEY&max_priority=2"

Position Codes

Basketball (NBA / WNBA / CBB)

Code	Position
`G`	Guard
`F`	Forward
`C`	Center
`G/F`	Guard/Forward
`F/C`	Forward/Center

Baseball (MLB)

Code	Position
`SP`	Starting Pitcher
`RP`	Relief Pitcher
`CP`	Closing Pitcher
`C`	Catcher
`1B`	First Base
`2B`	Second Base
`3B`	Third Base
`SS`	Shortstop
`LF`	Left Field
`CF`	Center Field
`RF`	Right Field
`OF`	Outfield
`DH`	Designated Hitter

Football (NFL / CFB)

Code	Position
`QB`	Quarterback
`RB`	Running Back
`FB`	Fullback
`WR`	Wide Receiver
`TE`	Tight End
`OT`	Offensive Tackle
`OG`	Offensive Guard
`C`	Center
`DE`	Defensive End
`DT`	Defensive Tackle
`LB`	Linebacker
`CB`	Cornerback
`S`	Safety
`K`	Kicker
`P`	Punter

Hockey (NHL)

Code	Position
`C`	Center
`LW`	Left Wing
`RW`	Right Wing
`D`	Defenseman
`G`	Goaltender

Injury Body Location & Type Fields

Injury objects contain structured Location, Type, Detail, and Side fields for precise filtering.

Location

The broad body region: Head, Torso, Arm, Leg, Foot, Not Specified

Type (within Location)

Examples by location:

Head: Concussion, Eye, Nose, Jaw
Torso: Back, Shoulder, Ribs, Abdomen
Arm: Elbow, Wrist, Hand, Finger
Leg: Knee, Thigh, Hamstring, Quadriceps, Hip, Heel, Groin, Calf
Foot: Ankle, Foot, Toe, Plantar Fascia, Achilles

Detail

The injury descriptor: Soreness, Strain, Sprain, Fracture, Contusion, Inflammation, Surgery, Not Specified

Side

Left, Right, Not Specified

Example injury object:

{
  "Status": "GTD",
  "Type": "Heel",
  "Location": "Leg",
  "Detail": "Contusion",
  "Side": "Right",
  "ReturnDate": null
}

Null fields: ReturnDate is frequently null — it is only populated when a specific return timeline has been communicated. Always null-check before using this field.

DateTime Format

All timestamps use ISO 8601 format with UTC offset:

2025-01-15T14:19:59-07:00

Parse with any standard ISO 8601 library. The offset reflects the editorial team's timezone and is not necessarily the game's local timezone.

from datetime import datetime
dt = datetime.fromisoformat("2025-01-15T14:19:59-07:00")

const dt = new Date("2025-01-15T14:19:59-07:00");

Team Code Reference

See the Leagues & Sports Reference page for a full list of league and team codes organized by sport.