NFL

Get a single player by id

get/api/v1/nfl/players/{id}

Request

  • Base URL: https://api.stat-api.com
  • URL: https://api.stat-api.com/api/v1/nfl/players/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

Primary Key

Primary key (id) of the players row.

Response

Single players row.

birth_citystring nullable
birth_countrystring nullable
birth_datestring date nullable
birth_statestring nullable
collegestring nullable

College or last football affiliation before turning pro.

draft_numberstring nullable

Pick number within the round; null or UDFA if undrafted.

draft_roundstring nullable

Draft round (1-7); null or UDFA if undrafted.

draft_yearstring nullable

Calendar year the player was drafted; null or UDFA if undrafted.

experienceinteger nullable

Years of NFL experience (rookies = 0).

first_namestring required
full_namestring required
full_position_liststring nullable

All positions the player is eligible at (semicolon-joined when multiple, e.g., RB;WR).

gsis_idstring required

Game Statistics and Information System ID (e.g. 00-0028830)

heightinteger nullable

Height in inches.

idinteger required

Primary Key

is_teamboolean required

True for synthetic team-level entities (DST, team defense). Used to distinguish team defense 'players' from individual players.

jerseystring nullable

Jersey number with the player's current team (string to preserve leading zeros and special codes).

last_namestring required
league_player_idstring nullable

Official NFL player ID (UUID) from nfl.com

nfl_slugstring nullable

URL slug used on nfl.com (e.g., patrick-mahomes).

overall_pickinteger nullable

Overall pick number across all rounds (1-262); null if undrafted.

position_groupstring nullable

Broad position group (e.g., OFFENSE, DEFENSE, ST).

primary_positionstring required

Primary roster position (e.g., QB, WR, RB, CB).

profile_pic_urlstring nullable

URL to player profile picture image

roster_statusstring nullable

Canonical roster status, shared across leagues. NFL has the richest source vocabulary. The "on a team now" set is {active, injured_reserve, practice_squad, reserve, suspended}; free_agent/waived/retired/inactive are off-roster.

team_idinteger nullable

Current NFL team (FK to teams); null for free agents and retired players.

weightinteger nullable

Weight in pounds.

Changes

No recorded changes to this operation across all 2 revisions of this API.