player_contractsnfl.player_contracts

NFL player contracts — total value, average annual pay, guaranteed money, and salary cap impact for every signed deal, with cap-inflated comparisons across eras.

Full field reference (19 columns) → Data Dictionary Query in GraphQL →

GET/api/v1/nfl/player_contractsList player_contracts for NFL

Requires one of: player_id — requests satisfying none of these return 400.

Parameters

player_idquerybigintoptional

Filter to a single player.

team_idquerybigintoptional

Filter by team.

positionquerystringoptional

Filter by player position. Values: C, CB, ED, FB, IDL, K, LB, LG, LS, LT, P, QB, RB, RG, RT, S, TE, WR.

limitqueryintegeroptionaldefault 50

Page size. Defaults to 50; max 5000.

from_idquerybigintoptional

Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.

Restores the documented defaults (trial keys only accept the unchanged defaults).

Request

curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/player_contracts?player_id=1'

Responses

200player_contracts rows matching the declared filter set, wrapped in { player_contracts, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸

400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json

Response Schema(19 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
player_id	bigint		— e.g. 1546
team_id	bigint		— e.g. 25
apy	bigint	—	Average annual value (APY) in U.S. dollars — total `value` divided by `years`. e.g. 895000
apy_cap_pct	decimal	—	APY as a percentage of the league salary cap in the signing year (0.0-100.0). e.g. 0.0040
college	stringnullable	—	— e.g. Florida State
date_of_birth	datenullable	—	— e.g. — (all-null in sample)
guaranteed	bigint	—	Total guaranteed money over the life of the contract, in U.S. dollars. e.g. 0
height	stringnullable	—	Height (e.g., `6-2`). Values:6'3"6'4"6'2"6'5"6'0"6'1"5'11"6'6"5'9"6'7"5'10"5'8"6'8"6'0'"
inflated_apy	bigint	—	`apy` adjusted to the most recent salary cap. e.g. 895000
inflated_guaranteed	bigint	—	`guaranteed` adjusted to the most recent salary cap. e.g. 0
inflated_value	bigint	—	`value` adjusted to the most recent salary cap, in U.S. dollars. e.g. 895000
is_active	boolean	—	True for the player's currently-active contract; false for historical contracts. e.g. true
position	string	—	Player position at the time the contract was signed. Values:WRCBEDSIDLLBTERBRTLTLGQBCRGKPFBLS
season_history_json	stringnullable	—	JSON-encoded year-by-year cap-hit breakdown for the life of the contract (stored as a string). e.g. — (all-null in sample)
value	bigint	—	Total contract value in U.S. dollars. e.g. 895000
weight	integernullable	—	Weight in pounds. e.g. 205
year_signed	integer	—	Calendar year the contract was signed. e.g. 2022
years	integer	—	Total contract length in years. e.g. 4

GET/api/v1/nfl/player_contracts/{id}Get a single player_contract by id

Parameters

idpathbigintrequired

Primary key (id) of the player_contract row.

Restores the documented defaults (trial keys only accept the unchanged defaults).

Request

curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/player_contracts/{pk_value}'

Responses

200Single player_contract row.application/jsonshow example ▸

404Row not found.

Response Schema(19 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
player_id	bigint		— e.g. 1546
team_id	bigint		— e.g. 25
apy	bigint	—	Average annual value (APY) in U.S. dollars — total `value` divided by `years`. e.g. 895000
apy_cap_pct	decimal	—	APY as a percentage of the league salary cap in the signing year (0.0-100.0). e.g. 0.0040
college	stringnullable	—	— e.g. Florida State
date_of_birth	datenullable	—	— e.g. — (all-null in sample)
guaranteed	bigint	—	Total guaranteed money over the life of the contract, in U.S. dollars. e.g. 0
height	stringnullable	—	Height (e.g., `6-2`). Values:6'3"6'4"6'2"6'5"6'0"6'1"5'11"6'6"5'9"6'7"5'10"5'8"6'8"6'0'"
inflated_apy	bigint	—	`apy` adjusted to the most recent salary cap. e.g. 895000
inflated_guaranteed	bigint	—	`guaranteed` adjusted to the most recent salary cap. e.g. 0
inflated_value	bigint	—	`value` adjusted to the most recent salary cap, in U.S. dollars. e.g. 895000
is_active	boolean	—	True for the player's currently-active contract; false for historical contracts. e.g. true
position	string	—	Player position at the time the contract was signed. Values:WRCBEDSIDLLBTERBRTLTLGQBCRGKPFBLS
season_history_json	stringnullable	—	JSON-encoded year-by-year cap-hit breakdown for the life of the contract (stored as a string). e.g. — (all-null in sample)
value	bigint	—	Total contract value in U.S. dollars. e.g. 895000
weight	integernullable	—	Weight in pounds. e.g. 205
year_signed	integer	—	Calendar year the contract was signed. e.g. 2022
years	integer	—	Total contract length in years. e.g. 4