API docs by Redocly

NFL REST APIs (1.0.0)

Download OpenAPI specification:

URL: https://www.nfl.com

Regular API - NFL's public API for accessing game schedules, team information, standings, statistics, and venue data. This API provides comprehensive access to NFL data including real-time game information, team rosters, seasonal statistics, and historical data. The NFL Pro API is for accessing advanced statistics, film room content, player data, and fantasy information. This API provides comprehensive access to NFL Pro features including Next Gen Stats, Film Room analysis, player projections, and game insights.

Authentication

Token generation and refresh operations for NFL API access

Generate Initial Access Token

Creates a new access token and refresh token for a client device. This is the initial authentication endpoint that establishes a session for accessing NFL APIs. Requires client credentials and device information.

Authorizations:
BearerAuth
Request Body schema: application/json
required
clientKey
required
string

Client application identifier key

clientSecret
required
string

Client application secret for authentication

deviceId
required
string <uuid>

Unique device identifier (UUID format)

deviceInfo
required
string

Base64-encoded JSON containing device information such as: {"model":"desktop","version":"Chrome","osName":"Windows","osVersion":"10"}

networkType
required
string
Enum: "other" "wifi" "cellular" "ethernet"

Type of network connection

Responses

Response Schema: application/json
accessToken
required
string

JWT access token containing user permissions, subscription plans, location data, and roles. Include this token in the Authorization header as "Bearer {accessToken}" for authenticated requests.

expiresIn
required
integer <int64>

Unix timestamp when the access token expires

refreshToken
required
string <uuid>

New refresh token for future token refresh requests

Request samples

Content type
application/json
{
  • "clientKey": "4cFUW6DmwJpzT9L7LrG3qRAcABG5s04g",
  • "clientSecret": "CZuvCL49d9OwfGsR",
  • "deviceId": "3cfdef35-c7fe-4f2d-8630-1ec72f52b44d",
  • "deviceInfo": "eyJtb2RlbCI6ImRlc2t0b3AiLCJ2ZXJzaW9uIjoiQ2hyb21lIiwib3NOYW1lIjoiV2luZG93cyIsIm9zVmVyc2lvbiI6IjEwIn0=",
  • "networkType": "other"
}

Response samples

Content type
application/json
{
  • "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  • "expiresIn": 1758732647,
  • "refreshToken": "0f5452b5-7f40-4c8e-9801-cf7fd2830de3"
}

Refresh Access Token

Refreshes an existing access token using a valid refresh token. This endpoint extends the user's session by generating new access and refresh tokens. Requires the previous refresh token and signature verification.

Authorizations:
BearerAuth
Request Body schema: application/json
required
clientKey
required
string

Client application identifier key

clientSecret
required
string

Client application secret for authentication

deviceId
required
string <uuid>

Unique device identifier (UUID format)

deviceInfo
required
string

Base64-encoded JSON containing device information such as: {"model":"desktop","version":"Chrome","osName":"Windows","osVersion":"10"}

networkType
required
string
Enum: "other" "wifi" "cellular" "ethernet"

Type of network connection

refreshToken
required
string <uuid>

Valid refresh token from previous authentication

signatureTimestamp
required
string

Unix timestamp for signature verification

uid
required
string

User identifier hash

uidSignature
required
string

HMAC signature for request verification

Responses

Response Schema: application/json
accessToken
required
string

JWT access token containing user permissions, subscription plans, location data, and roles. Include this token in the Authorization header as "Bearer {accessToken}" for authenticated requests.

expiresIn
required
integer <int64>

Unix timestamp when the access token expires

refreshToken
required
string <uuid>

New refresh token for future token refresh requests

Request samples

Content type
application/json
{
  • "clientKey": "4cFUW6DmwJpzT9L7LrG3qRAcABG5s04g",
  • "clientSecret": "CZuvCL49d9OwfGsR",
  • "deviceId": "3cfdef35-c7fe-4f2d-8630-1ec72f52b44d",
  • "deviceInfo": "eyJtb2RlbCI6ImRlc2t0b3AiLCJ2ZXJzaW9uIjoiQ2hyb21lIiwib3NOYW1lIjoiV2luZG93cyIsIm9zVmVyc2lvbiI6IjEwIn0=",
  • "networkType": "other",
  • "refreshToken": "640b00c7-33d8-44f2-ab46-e3d1284a4061",
  • "signatureTimestamp": "1758729181",
  • "uid": "df990acd951e4bd6940c3babc4341584",
  • "uidSignature": "587bdNt6EKYhhX9ASFOELX+2lqE="
}

Response samples

Content type
application/json
{
  • "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  • "expiresIn": 1758732782,
  • "refreshToken": "a175ada6-a2e2-4689-8ea4-b9d6cfb0da13"
}

Betting

Game betting odds and lines

Get Weekly Betting Odds

Retrieves comprehensive betting odds for all games in a specified week. Returns point spreads, money lines, and totals (over/under) for each game with the latest odds updates from betting markets.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

Responses

Response Schema: application/json
Array of objects (GameOdds)
season
string

Season year

seasonType
string
Enum: "PRE" "REG" "POST"

Type of season

week
string

Week number

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "season": "2025",
  • "seasonType": "REG",
  • "week": "4"
}

Content

Game previews, film cards, and insights

Get Game Preview Content

Retrieves preview content and insights for a specific game based on teams and week. Returns preview information, matchup analysis, and key storylines.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer
Example: week=4

Week number

visitorDisplayName
required
string
Example: visitorDisplayName=Minnesota Vikings

Visiting team display name

homeDisplayName
required
string
Example: homeDisplayName=Pittsburgh Steelers

Home team display name

Responses

Response Schema: application/json
preview
object or null

Preview content and analysis

Response samples

Content type
application/json
{
  • "preview": { }
}

Get Home Film Cards

Retrieves featured film room content cards for the home page. Returns weekly playlists and featured player film breakdowns.

Authorizations:
BearerAuth

Responses

Response Schema: application/json
required
Array of objects (FilmCard)
title
required
string

Title of the film card collection

Response samples

Content type
application/json
{
  • "cards": [
    ],
  • "title": "Week 3 Playlists"
}

Get Game-Specific Insights

Retrieves analytical insights and advanced statistics for a specific game. Can filter by tags and exclude specific content types.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

limit
integer [ 1 .. 100 ]
Default: 20
Example: limit=100

Maximum number of insights to return

tags
string
Example: tags=pro-preview

Comma-separated list of tags to filter by

excludeTags
string
Example: excludeTags=betting

Comma-separated list of tags to exclude

fapiGameId
required
string <uuid>
Example: fapiGameId=f688dfde-311e-11f0-b670-ae1250fadad1

FAPI Game identifier (UUID)

awayTeamId
required
string
Example: awayTeamId=3000

Away team identifier

homeTeamId
required
string
Example: homeTeamId=3900

Home team identifier

Responses

Response Schema: application/json
Array
content
object

Insight content and analysis

gameId
string

Game identifier

id
string

Insight identifier

type
string

Type of insight

Response samples

Content type
application/json
[
  • {
    }
]

Get player charts

Returns route charts, pass charts, and carry charts for players

Authorizations:
BearerAuth
query Parameters
count
integer
Default: 12
Example: count=12
season
required
integer
Example: season=2025
week
string
Default: "all"
Example: week=all

Week number or "all"

type
string
Default: "all"
Enum: "all" "route" "pass" "carry"
Example: type=all

Chart type filter

teamId
string
Default: "all"
Example: teamId=all

Team ID or "all"

esbId
string
Default: "all"
Example: esbId=all

Player ESB ID or "all"

Responses

Response Schema: application/json
Array of objects (Chart)
count
integer
offset
integer
total
integer
season
string
teamId
string
type
string
week
string
seasonType
string

Response samples

Content type
application/json
{
  • "charts": [
    ],
  • "count": 0,
  • "offset": 0,
  • "total": 0,
  • "season": "string",
  • "teamId": "string",
  • "type": "string",
  • "week": "string",
  • "seasonType": "string"
}

Get players list for charts

Returns a list of players available in the chart system

Authorizations:
BearerAuth

Responses

Response Schema: application/json
Array of objects

Response samples

Content type
application/json
{
  • "players": [
    ]
}

Get play highlights

Returns highlighted plays from games

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 16
Example: limit=16
season
required
integer
Example: season=2025

Responses

Response Schema: application/json
season
integer
Array of objects (Highlight)
total
integer
count
integer
offset
integer
limit
integer

Response samples

Content type
application/json
{
  • "season": 0,
  • "highlights": [
    ],
  • "total": 0,
  • "count": 0,
  • "offset": 0,
  • "limit": 0
}

Content Insights

Editorial insights and analytics content about NFL players and games

Get Season Content Insights

Retrieves curated editorial insights and analytics content for NFL players during a specified season. Returns expert commentary combining Next Gen Stats data with editorial analysis, including pregame previews, postgame breakdowns, fantasy insights, and evergreen content. Supports filtering by player, team, content tags, and publication limits for targeted content discovery.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

limit
integer [ 1 .. 100 ]
Default: 20
Example: limit=60

Maximum number of insights to return

tags
Array of strings
Items Enum: "nfl-pro" "editorial" "next-gen-stats" "pregame" "postgame" "fantasy" "pro-preview" "pro-matchup" "evergreen"
Example: tags=nfl-pro

Content tags to filter by (supports multiple comma-separated tags)

teamId
string
Example: teamId=3900

Filter by specific team identifier

nflId
string
Example: nflId=46101

Filter by specific player NFL identifier

Responses

Response Schema: application/json
Array
createdAt
required
string <date-time>

Content creation timestamp

createdBy
required
string

Content creator identifier

date
required
string <date>

Content publication date

esbId
string

ESB player identifier

evergreen
required
boolean
Default: false

Whether content is evergreen (timeless) or time-sensitive

gameId
integer or null

Game identifier (10-digit format YYYYMMDDNN)

gsisId
string

GSIS player identifier

headshot
string <uri>

URL to player headshot image (contains formatInstructions placeholder)

id
required
string

Unique content identifier

imageUrl
string or null <uri>

Associated image or chart URL (optional)

jerseyNumber
integer

Player's jersey number

nflId
required
integer

NFL player identifier

playerName
required
string

Player's full name

position
required
string
Enum: "QB" "RB" "WR" "TE" "OL" "DL" "LB" "DB" "K" "P"

Player position

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

secondTeamAbbr
string or null

Opponent or related team abbreviation

secondTeamId
string or null

Opponent or related team identifier

secondTeamType
string or null
Enum: "offense" "defense"

Context of the second team (typically "defense" for opponent)

smartId
string <uuid>

Smart player identifier

subNote1
string

Detailed insight content and analysis

tags
required
Array of strings

Content classification tags

teamAbbr
required
string

Player's team abbreviation

teamId
required
string

Player's team identifier

title
required
string

Main insight headline or title

updatedAt
required
string <date-time>

Last update timestamp

updatedBy
required
string

Last editor identifier

week
required
integer

Week number (if applicable)

Response samples

Content type
application/json
[
  • {
    }
]

Defensive Pass Rush Statistics

Individual defensive player pass rush statistics and analytics

Get Defensive Pass Rush Statistics by Season

Retrieves comprehensive pass rush statistics for NFL defensive players during a specified season. Returns detailed metrics including pressures, sacks, quarterback hits, time to throw allowed, pass rush productivity, and Next Gen Stats data. Supports filtering by qualified defenders, teams, and various sorting options. Data includes traditional pass rush stats and advanced analytics like pass rush grade, pressure rate, and time to sack metrics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "pr"
Enum: "pr" "prR" "qbp" "qbpR" "ttp" "qp" "sack" "sackR" "tts" "prGo" "turnQbp" "gameSnap"
Example: sortKey=pr

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedDefender
boolean
Default: false
Example: qualifiedDefender=false

Filter to only qualified defenders (minimum snap threshold)

Responses

Response Schema: application/json
required
Array of objects (DefensivePassRushStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedDefender
boolean

Whether results are filtered to qualified defenders only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "defenders": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "qualifiedDefender": false,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "pr",
  • "sortValue": "DESC",
  • "total": 730
}

Defensive Player Overview

Comprehensive individual defensive player statistics and analytics

Get Defensive Player Overview Statistics by Season

Retrieves comprehensive defensive overview statistics for NFL players during a specified season. Returns detailed metrics including traditional defensive stats (tackles, stops, sacks), coverage metrics (targets, completions allowed, pass rating allowed), pass rush data, and advanced analytics. Supports filtering by qualified defenders, teams, and various sorting options. Data includes snap counts, tackle efficiency, coverage effectiveness, and situational performance.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=3

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "snap"
Enum: "snap" "rd" "pr" "tck" "tStop" "hStop" "qbp" "qbpR" "sack" "tgtNd" "recNd" "recYdsNd" "recTdNd" "int" "passRatingNd" "gameSnap" "snapPct"
Example: sortKey=sack

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedDefender
boolean
Default: false
Example: qualifiedDefender=false

Filter to only qualified defenders (minimum snap threshold)

teamDefense
Array of strings
Example: teamDefense=3000&teamDefense=3900

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
required
Array of objects (DefensivePlayerOverviewStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedDefender
boolean

Whether results are filtered to qualified defenders only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamDefense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "defenders": [
    ],
  • "limit": 3,
  • "offset": 0,
  • "qualifiedDefender": false,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamDefense": "3900",
  • "total": 26
}

Defensive Statistics

Individual defensive player statistics and coverage analytics

Get Defensive Player Statistics by Season

Retrieves comprehensive defensive statistics for NFL players during a specified season. Returns detailed coverage metrics including targets allowed, completion rates, pass rating allowed, yards after catch prevention, and advanced Next Gen Stats data. Supports filtering by qualified defenders, teams, and various sorting options. Data includes traditional defensive stats and advanced analytics like EPA (Expected Points Added), CROE (Completion Rate Over Expected), receiver separation allowed, and coverage snap counts.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "cov"
Enum: "cov" "covNd" "tgtNd" "recNd" "recYdsNd" "recTdNd" "int" "passRatingNd" "tgtEpaNd" "catchNd" "croeNd" "bhPct" "sep" "twfPct" "yacprNd" "tgtRNd"
Example: sortKey=cov

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedDefender
boolean
Default: false
Example: qualifiedDefender=false

Filter to only qualified defenders (minimum snap threshold)

teamDefense
Array of strings
Example: teamDefense=3800&teamDefense=1800

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
required
Array of objects (DefensivePlayerStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedDefender
boolean

Whether results are filtered to qualified defenders only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "defenders": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "qualifiedDefender": false,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "cov",
  • "sortValue": "DESC",
  • "total": 730
}

Experience

Experience API endpoints for games and teams

Get Games by Season and Week

Retrieves game information for a specific season, season type, and week. Returns comprehensive game data including teams, venues, broadcast information, and ticket details.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year (e.g., 2025)

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

Responses

Response Schema: application/json
Array of objects (ProGame)
object (Pagination)

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "pagination": {
    }
}

Get All Teams

Retrieves information for all NFL teams including Pro Bowl teams. Returns comprehensive team data including logos, colors, venues, and social media links.

Authorizations:
BearerAuth
query Parameters
allteams
boolean
Example: allteams=true

Include all teams including special teams

season
required
integer
Example: season=2025

Season year

Responses

Response Schema: application/json
Array of objects (Team)

Response samples

Content type
application/json
{
  • "teams": [
    ]
}

Fantasy Statistics

Fantasy football player statistics and scoring metrics

Get Fantasy Football Statistics by Season

Retrieves comprehensive fantasy football statistics for NFL players during a specified season. Returns fantasy-relevant metrics including standard scoring, PPR scoring, snap counts, and target share data. Supports filtering by position groups (QB, RB, WR, TE, SPEC), teams, minimum offensive snap thresholds, and rolling N-week windows for recent performance analysis. Data includes traditional fantasy categories and advanced metrics for lineup optimization.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "fpStd"
Enum: "fpStd" "fpPpr" "fpHalfPpr" "passYds" "passTd" "passInt" "rushYds" "rushTd" "recYds" "recTd" "rec" "tgt" "snapPct" "targetShare" "redZoneTargets"
Example: sortKey=fpStd

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

positionGroup
Array of strings
Items Enum: "QB" "RB" "WR" "TE" "SPEC"
Example: positionGroup=QB

Filter by position groups (supports multiple positions)

teamOffense
string
Example: teamOffense=3900

Filter by specific offensive team ID

teamDefense
string
Example: teamDefense=4600

Filter by specific defensive team ID (opponent analysis)

minOffensiveSnaps
integer >= 0
Default: 0
Example: minOffensiveSnaps=75

Minimum offensive snaps threshold for inclusion

lastNWeeks
integer [ 1 .. 18 ]
Example: lastNWeeks=3

Number of recent weeks to analyze (rolling window)

Responses

Response Schema: application/json
lastNWeeks
integer

Number of recent weeks analyzed (if applied)

limit
required
integer

Maximum number of results returned

minOffensiveSnaps
integer

Minimum offensive snaps filter applied

offset
required
integer

Number of records skipped

required
Array of objects (FantasyPlayerStats)
positionGroup
Array of strings

Position groups included in results

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Offensive team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
Array of strings

Specific weeks included in analysis

Response samples

Content type
application/json
{
  • "lastNWeeks": 3,
  • "limit": 35,
  • "minOffensiveSnaps": 75,
  • "offset": 0,
  • "players": [
    ],
  • "positionGroup": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "fpStd",
  • "sortValue": "DESC",
  • "teamOffense": "3900",
  • "total": 0,
  • "week": [
    ]
}

Filmroom

Advanced play analysis and film study data

Get Filmroom Plays with Advanced Filtering

Retrieves detailed play-by-play data with extensive filtering capabilities for film study. Returns comprehensive play information including formations, personnel packages, game situations, and detailed play descriptions. This endpoint supports advanced filtering by game situation, player involvement, formation types, and tactical elements.

Authorizations:
BearerAuth
query Parameters
gameId
Array of strings <uuid> [ items <uuid > ]
Example: gameId=f665fc10-311e-11f0-b670-ae1250fadad1

Filter by specific game IDs (supports multiple values)

weekSlug
Array of strings
Items Enum: "WEEK_1" "WEEK_2" "WEEK_3" "WEEK_4" "WEEK_5" "WEEK_6" "WEEK_7" "WEEK_8" "WEEK_9" "WEEK_10" "WEEK_11" "WEEK_12" "WEEK_13" "WEEK_14" "WEEK_15" "WEEK_16" "WEEK_17" "WEEK_18"
Example: weekSlug=WEEK_3

Filter by week identifier (supports multiple values)

season
Array of integers
Example: season=2025

Filter by season year (supports multiple values)

seasonType
Array of strings
Items Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Filter by season type

nflId
Array of strings
Example: nflId=54517

Filter by player NFL ID

quarter
Array of integers[ items [ 1 .. 4 ] ]
Example: quarter=1

Filter by quarter

down
Array of integers[ items [ 1 .. 4 ] ]
Example: down=1

Filter by down

yardsToGoType
Array of strings
Items Enum: "SHORT" "MID" "LONG"
Example: yardsToGoType=SHORT

Filter by yards to go category

touchdown
Array of integers
Items Enum: 0 1
Example: touchdown=1

Filter for touchdown plays (1 = yes, 0 = no)

rush10PlusYards
Array of integers
Items Enum: 0 1
Example: rush10PlusYards=1

Filter for rushing plays of 10+ yards

fumbleLost
Array of integers
Items Enum: 0 1
Example: fumbleLost=1

Filter for plays with fumbles lost

fumble
Array of integers
Items Enum: 0 1
Example: fumble=1

Filter for plays with fumbles

qbAlignment
Array of strings
Items Enum: "PISTOL" "UNDER_CENTER" "SHOTGUN"
Example: qbAlignment=SHOTGUN

Filter by quarterback alignment

redzone
Array of integers
Items Enum: 0 1
Example: redzone=1

Filter for red zone plays

goalToGo
Array of integers
Items Enum: 0 1
Example: goalToGo=1

Filter for goal-to-go situations

passPlay
Array of integers
Items Enum: 0 1
Example: passPlay=1

Filter for passing plays

runPlay
Array of integers
Items Enum: 0 1
Example: runPlay=1

Filter for running plays

playType
Array of strings
Items Enum: "play_type_kickoff" "play_type_field_goal" "play_type_rush" "play_type_sack" "play_type_two_point_conversion" "play_type_xp" "play_type_pass" "play_type_punt" "play_type_unknown"
Example: playType=play_type_rush

Filter by specific play types

attempt
Array of integers
Items Enum: 0 1
Example: attempt=1

Filter for passing attempts

completion
Array of integers
Items Enum: 0 1
Example: completion=1

Filter for completed passes

interception
Array of integers
Items Enum: 0 1
Example: interception=1

Filter for interceptions

reception
Array of integers
Items Enum: 0 1
Example: reception=1

Filter for receptions

sack
Array of integers
Items Enum: 0 1
Example: sack=1

Filter for sacks

rec_motion
Array of integers
Items Enum: 0 1
Example: rec_motion=1

Filter by receiver motion

targetLocation
Array of strings
Items Enum: "DOWN_SEAMS" "BETWEEN_HASHES" "OUTSIDE_NUMBERS"
Example: targetLocation=BETWEEN_HASHES

Filter by target location on field

airYardType
Array of strings
Items Enum: "INTERMEDIATE" "SHORT" "DEEP"
Example: airYardType=SHORT

Filter by air yards category

dropbackTimeType
Array of strings
Items Enum: "QUICK" "LONG"
Example: dropbackTimeType=QUICK

Filter by dropback time

pressure
Array of integers
Items Enum: 0 1
Example: pressure=1

Filter by quarterback pressure

blitz
Array of integers
Items Enum: 0 1
Example: blitz=1

Filter by defensive blitz

playAction
Array of integers
Items Enum: 0 1
Example: playAction=1

Filter by play action usage

rushDirection
Array of strings
Items Enum: "INSIDE" "OUTSIDE"
Example: rushDirection=INSIDE

Filter by rush direction

runStuff
Array of integers
Items Enum: 0 1
Example: runStuff=1

Filter for stuffed runs

receiverAlignment
Array of strings
Items Enum: "SLOT" "BACKFIELD" "TIGHT" "WIDE"
Example: receiverAlignment=SLOT

Filter by receiver alignment

separationType
Array of strings
Items Enum: "OPEN" "TIGHT"
Example: separationType=OPEN

Filter by receiver separation

personnel
Array of strings
Items Enum: "NICKEL" "BASE" "DIME"
Example: personnel=NICKEL

Filter by defensive personnel package

defendersInTheBoxType
Array of strings
Items Enum: "LIGHT" "STACKED" "NEUTRAL"
Example: defendersInTheBoxType=STACKED

Filter by defenders in the box

def_coverageType
Array of strings
Items Enum: "PRESS" "MAN" "ZONE"
Example: def_coverageType=PRESS

Filter by defensive coverage type

Responses

Response Schema: application/json
count
required
integer

Total number of plays matching the filter criteria

required
Array of objects (FilmroomPlay)

Array of play data matching the filter criteria

Response samples

Content type
application/json
{
  • "count": 148,
  • "plays": [
    ]
}

Football

Football API endpoints for games, standings, stats, and venues

Get Draft Information

Retrieves draft information for a specific year including all rounds, picks, traded picks, and compensatory selections.

Authorizations:
BearerAuth
path Parameters
year
required
integer
Example: 2025

Draft year

query Parameters
round
integer [ 1 .. 7 ]

Filter by round

teamId
string <uuid>

Filter by team

Responses

Response Schema: application/json
Array of objects
year
integer

Response samples

Content type
application/json
{
  • "rounds": [
    ],
  • "year": 0
}

Get Weekly Game Details with Standings

Retrieves detailed game information for a specific week including team standings, drive charts, replays, and tagged videos.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

type
required
string
Enum: "PRE" "REG" "POST"
Example: type=REG

Season type

week
required
integer
Example: week=4

Week number

includeDriveChart
boolean
Default: false

Include drive chart data

includeReplays
boolean
Default: false

Include replay videos

includeStandings
boolean
Default: false

Include team standings

includeTaggedVideos
boolean
Default: false

Include tagged video content

Responses

Response Schema: application/json
Array
object (Team)
object (BroadcastInfo)
category
string or null
Enum: "TNF" "SNF" "MNF"

Prime time game designation

date
string <date>

Game date (YYYY-MM-DD)

dateAmPm
string
Enum: "AM" "PM"
dateDay
string

Day of week (full)

dateDayMonth
string

Date in M/D format

dateDayShort
string

Day of week (abbreviated)

dateTime
string

Time without AM/PM

dateTimeAmPm
string

Time with AM/PM

extensions
Array of objects

Additional game data extensions

Array of objects (ExternalId)
gameType
string

Type of game

object (Team)
id
string <uuid>

Unique game identifier

international
boolean

Whether game is played internationally

neutralSite
boolean

Whether game is at neutral venue

phase
string

Game phase

season
integer

Season year

seasonType
string
Enum: "PRE" "REG" "POST"

Season type

status
string
Enum: "SCHEDULED" "IN_PROGRESS" "FINAL" "POSTPONED" "CANCELLED"

Game status

ticketUrl
string or null <uri>

Primary ticket purchase URL

Array of objects (TicketVendor)
time
string <date-time>

Game time in UTC

object (Venue)
version
integer

Data version number

week
integer

Week number

weekType
string

Week type (e.g., REG, HOF)

object (Standings)
driveChart
object or null

Drive-by-drive data

object (Standings)
replays
Array of objects

Replay video links

summary
object or null

Game summary information

taggedVideos
object or null

Tagged video content

Response samples

Content type
application/json
[
  • {
    }
]

Get Games by Season, Type, and Week

Retrieves game information for a specific season, season type, and week from the Football API. This endpoint provides core game data with external IDs.

Authorizations:
BearerAuth
path Parameters
season
required
integer
Example: 2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: REG

Type of season

week
required
integer
Example: 4

Week number

query Parameters
withExternalIds
boolean
Default: false

Include external IDs in response

Responses

Response Schema: application/json
Array of objects (ProGame)
object (Pagination)

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "pagination": {
    }
}

Get Game Box Score

Retrieves comprehensive box score data for a specific game including team statistics, individual player statistics, and scoring summary.

Authorizations:
BearerAuth
path Parameters
gameId
required
string <uuid>

Game identifier (UUID)

Responses

Response Schema: application/json
object (ProGame)
object
Array of objects (ScoringPlay)
object

Response samples

Content type
application/json
{
  • "game": {
    },
  • "playerStats": {
    },
  • "scoringSummary": [
    ],
  • "teamStats": {
    }
}

Get Play-by-Play Data

Retrieves detailed play-by-play data for a specific game including all plays, drives, scoring events, and key statistics.

Authorizations:
BearerAuth
path Parameters
gameId
required
string <uuid>

Game identifier (UUID)

query Parameters
includePenalties
boolean
Default: true

Include penalty details

includeFormations
boolean
Default: false

Include offensive/defensive formations

Responses

Response Schema: application/json
object (Drive)
Array of objects (Drive)
object (ProGame)
object (Play)
Array of objects (ScoringPlay)

Response samples

Content type
application/json
{
  • "currentDrive": {
    },
  • "drives": [
    ],
  • "game": {
    },
  • "lastPlay": {
    },
  • "scoringSummary": [
    ]
}

Get Injury Reports

Retrieves current injury reports for all teams or specific teams with injury status, designation, and practice participation.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

week
required
integer
Example: week=4

Week number

teamId
string <uuid>

Filter by specific team

Responses

Response Schema: application/json
Array of objects (TeamInjuryReport)
season
integer
week
integer

Response samples

Content type
application/json
{
  • "reports": [
    ],
  • "season": 0,
  • "week": 0
}

Get Team Roster

Retrieves the complete roster for a specific team including active, practice squad, and injured reserve players with detailed player information.

Authorizations:
BearerAuth
path Parameters
teamId
required
string <uuid>
Example: 10403800-517c-7b8c-65a3-c61b95d86123

Team identifier (UUID)

query Parameters
season
required
integer
Example: season=2025

Season year

includeStats
boolean
Default: false

Include current season statistics

Responses

Response Schema: application/json
object
season
integer
object (Team)

Response samples

Content type
application/json
{
  • "roster": {
    },
  • "season": 0,
  • "team": {
    }
}

Get Player Details

Retrieves detailed information about a specific player including biography, career statistics, and current season performance.

Authorizations:
BearerAuth
path Parameters
playerId
required
string
Example: 2560726

Player identifier

query Parameters
season
integer
Example: season=2025

Season for statistics (defaults to current)

Responses

Response Schema: application/json
birthDate
string <date>

Player's birth date

collegeConference
string

Player's college conference

collegeName
string

Player's college

currentTeamId
string

Current team identifier

displayName
string

Player's display name

draftClub
string or null

Team that drafted the player

draftNumber
integer or null

Overall draft pick number

draftround
integer or null

Draft round

entryYear
integer

Year player entered the league

esbId
string

ESB identifier

firstName
string

Player's first name

footballName
string

Player's football name (nickname)

gsisId
string

GSIS identifier

gsisItId
integer

GSIS IT identifier

headshot
string <uri>

URL to player headshot image

height
string

Player height (format is feet-inches)

jerseyNumber
integer

Player's jersey number

lastName
string

Player's last name

nflId
integer

NFL player identifier

ngsPosition
string or null

Next Gen Stats position

ngsPositionGroup
string or null

Next Gen Stats position group

position
string

Player's position

positionGroup
string

Player's position group

rookieYear
integer

Player's rookie year

season
integer

Current season

shortName
string

Shortened player name

smartId
string <uuid>

Smart identifier for the player

status
string

Player status code

statusDescriptionAbbr
string

Abbreviated status description

statusShortDescription
string

Short status description

teamAbbr
string

Current team abbreviation

uniformNumber
string

Player's uniform number (formatted)

weight
integer

Player weight in pounds

yearsOfExperience
integer

Years of NFL experience

Array of objects (Award)
biography
string

Player biography

object (CareerStats)
object (ContractInfo)
object (SeasonStats)

Response samples

Content type
application/json
{
  • "birthDate": "2019-08-24",
  • "collegeConference": "Southeastern Conference",
  • "collegeName": "Louisiana State",
  • "currentTeamId": "string",
  • "displayName": "Justin Jefferson",
  • "draftClub": "string",
  • "draftNumber": 0,
  • "draftround": 0,
  • "entryYear": 0,
  • "esbId": "string",
  • "firstName": "string",
  • "footballName": "string",
  • "gsisId": "string",
  • "gsisItId": 0,
  • "headshot": "http://example.com",
  • "height": "6-3",
  • "jerseyNumber": 0,
  • "lastName": "string",
  • "nflId": 52430,
  • "ngsPosition": "string",
  • "ngsPositionGroup": "string",
  • "position": "WR",
  • "positionGroup": "WR",
  • "rookieYear": 0,
  • "season": 0,
  • "shortName": "J.Jefferson",
  • "smartId": "884e3ef1-4039-4f0d-913c-7988cf03848f",
  • "status": "ACT",
  • "statusDescriptionAbbr": "A01",
  • "statusShortDescription": "Active",
  • "teamAbbr": "string",
  • "uniformNumber": "18",
  • "weight": 0,
  • "yearsOfExperience": 0,
  • "awards": [
    ],
  • "biography": "string",
  • "careerStats": {
    },
  • "contractInfo": {
    },
  • "currentSeasonStats": {
    }
}

Get Standings

Retrieves team standings for a specific season, season type, and week. Includes division, conference, and overall standings with detailed statistics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer
Example: week=3

Week number

limit
integer [ 1 .. 100 ]
Default: 20

Maximum number of results to return

Responses

Response Schema: application/json
object (Pagination)
season
integer
seasonType
string
Enum: "PRE" "REG" "POST"
week
integer

Current week for standings

Array of objects

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "season": 0,
  • "seasonType": "PRE",
  • "week": 0,
  • "weeks": [
    ]
}

Get Live Game Statistics

Retrieves live game statistics and summaries for games in progress or completed games. Provides real-time statistical data for specified season, type, and week.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer
Example: week=4

Week number

Responses

Response Schema: application/json
data
Array of objects
object (Pagination)

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "pagination": {
    }
}

Get Season Player Statistics

Retrieves aggregated player statistics for a specific season with filtering options by position, team, and statistical categories.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

position
string
Enum: "QB" "RB" "WR" "TE" "OL" "DL" "LB" "DB" "K" "P" "LS"

Filter by position group

teamId
string <uuid>

Filter by team

statCategory
string
Enum: "passing" "rushing" "receiving" "defense" "kicking" "punting" "returning"
Example: statCategory=passing

Statistical category to retrieve

sort
string
Example: sort=passingYards:desc

Sort field and order

limit
integer [ 1 .. 500 ]
Default: 50

Maximum number of results

offset
integer >= 0
Default: 0

Offset for pagination

Responses

Response Schema: application/json
object
Array of objects
season
integer
seasonType
string
statCategory
string

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "players": [
    ],
  • "season": 0,
  • "seasonType": "string",
  • "statCategory": "string"
}

Get Transactions

Retrieves recent transactions including trades, signings, releases, practice squad moves, and injured reserve designations.

Authorizations:
BearerAuth
query Parameters
startDate
string <date>
Example: startDate=2025-01-01

Start date for transactions (ISO 8601)

endDate
string <date>
Example: endDate=2025-09-24

End date for transactions (ISO 8601)

teamId
string <uuid>

Filter by team

transactionType
string
Enum: "TRADE" "SIGNED" "RELEASED" "WAIVED" "PRACTICE_SQUAD" "IR" "SUSPENDED"

Type of transaction

limit
integer [ 1 .. 100 ]
Default: 20

Maximum number of results

Responses

Response Schema: application/json
object (Pagination)
Array of objects (Transaction)

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "transactions": [
    ]
}

Get NFL Venues

Retrieves information about all NFL stadiums and venues, including international venues. Provides venue details such as addresses, locations, and territories.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

limit
integer [ 1 .. 100 ]
Default: 20

Maximum number of venues to return

Responses

Response Schema: application/json
object (Pagination)
Array of objects (Venue)

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "venues": [
    ]
}

Get Season Weeks

Retrieves all weeks for a specific season including preseason, regular season, and postseason. Includes bye team information for each week.

Authorizations:
BearerAuth
path Parameters
season
required
integer
Example: 2025

Season year

query Parameters
limit
integer [ 1 .. 100 ]
Default: 20

Maximum number of weeks to return

Responses

Response Schema: application/json
object (Pagination)
Array of objects (ProWeek)

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "weeks": [
    ]
}

Game Center

Live game data and scores

Get game center overview

Returns detailed game overview including passing zones, rushing stats, receivers, and pass rushers

Authorizations:
BearerAuth
query Parameters
gameId
required
integer
Example: gameId=2025112700

The unique game identifier

Responses

Response Schema: application/json
object (GameScheduleInfo)
object (PassersOverview)
object (RushersOverview)
object (ReceiversOverview)
object (PassRushersOverview)
object (GameLeaders)

Response samples

Content type
application/json
{
  • "schedule": {
    },
  • "passers": {
    },
  • "rushers": {
    },
  • "receivers": {
    },
  • "passRushers": {
    },
  • "leaders": {
    }
}

Get live game scores

Returns live scores for games in a specific week

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
required
integer
Example: week=13

Responses

Response Schema: application/json
season
integer
seasonType
string
week
integer
Array of objects (NGSGameScore)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "week": 0,
  • "scores": [
    ]
}

Leaders

Top plays and leaderboards

Get longest plays by distance

Returns leaderboard of longest plays by in-play distance covered

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 20
Example: limit=20
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=2

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (DistanceLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "leaders": [
    ]
}

Get longest tackles

Returns leaderboard of longest distance covered to make a tackle

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 20
Example: limit=20
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=2

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (TackleLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "leaders": [
    ]
}

Get improbable completions

Returns leaderboard of most improbable pass completions based on completion probability

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (CompletionLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "completionLeaders": [
    ]
}

Get remarkable rushes

Returns leaderboard of rush yards over expected

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (ERYLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "eryLeaders": [
    ]
}

Get incredible YAC plays

Returns leaderboard of yards after catch over expectation

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (YACLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "yacLeaders": [
    ]
}

Get fastest ball carriers

Returns leaderboard of fastest ball carrier speeds

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 20
Example: limit=20
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=2

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (SpeedLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "leaders": [
    ]
}

Get fastest sacks

Returns leaderboard of fastest sack times

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 20
Example: limit=20
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=2

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
leagueAverage
number
Array of objects (SackLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "leagueAverage": 0,
  • "leaders": [
    ]
}

League

League-wide schedule and team information

Get full season schedule

Returns the full schedule for a given season

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

The NFL season year

Responses

Response Schema: application/json
Array
gameKey
integer
gameId
integer
gameDate
string
gameTime
string <date-time>
gameTimeEastern
string
gameType
string
Enum: "PRE" "REG" "POST"
season
integer
seasonType
string
week
integer
weekNameAbbr
string
smartId
string
isoTime
integer <int64>
networkChannel
string
ngsGame
boolean
homeTeamId
string
homeTeamAbbr
string
homeDisplayName
string
homeNickname
string
object (TeamInfo)

Basic team information included in roster responses

visitorTeamId
string
visitorTeamAbbr
string
visitorDisplayName
string
visitorNickname
string
object (TeamInfo)

Basic team information included in roster responses

object (Site)
object (Score)
releasedToClubs
boolean
validated
boolean

Response samples

Content type
application/json
[
  • {
    }
]

Get current week schedule

Returns the schedule for the current week of the NFL season

Authorizations:
BearerAuth

Responses

Response Schema: application/json
season
integer
seasonType
string
week
integer
Array of objects (NGSScheduledGame)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "week": 0,
  • "games": [
    ]
}

Get all NFL teams

Returns a list of all NFL teams with their details

Authorizations:
BearerAuth

Responses

Response Schema: application/json
Array
teamId
string
smartId
string
abbr
string
cityState
string
fullName
string
nick
string
logo
string
teamType
string
Enum: "TEAM" "PRO"
conferenceAbbr
string
object (Conference)
object (Division)
stadiumName
string
teamSiteUrl
string or null
teamSiteTicketUrl
string or null
ticketPhoneNumber
string or null
yearFound
integer
season
integer

Response samples

Content type
application/json
[
  • {
    }
]

News

Articles, videos, and news content (uses api.nfl.com)

Get NGS articles

Returns articles filtered by category.

Note: This endpoint uses a different base URL: https://api.nfl.com

Authorizations:
BearerAuth
query Parameters
category
required
string
Example: category=next-gen-stats-news

Article category slug

limit
integer
Default: 16
Example: limit=16
offset
integer
Default: 0
Example: offset=32

Responses

Response Schema: application/json
Array of objects (ContentItem)
object (ContentMetadata)
object (NGSPagination)

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "metadata": {
    },
  • "pagination": {
    }
}

Get mixed NGS content

Returns mixed content (articles, videos) related to Next Gen Stats.

Note: This endpoint uses a different base URL: https://api.nfl.com

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 16
Example: limit=16
offset
integer
Default: 0
Example: offset=28

Responses

Response Schema: application/json
Array of objects (ContentItem)
object (ContentMetadata)
object (NGSPagination)

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "metadata": {
    },
  • "pagination": {
    }
}

Get NGS video clips

Returns video clips filtered by video channel.

Note: This endpoint uses a different base URL: https://api.nfl.com

Authorizations:
BearerAuth
query Parameters
videoChannel
required
string
Example: videoChannel=next-gen-stats-vc

Video channel slug

limit
integer
Default: 16
Example: limit=16
offset
integer
Default: 0
Example: offset=32

Responses

Response Schema: application/json
Array of objects (ContentItem)
object (ContentMetadata)
object (NGSPagination)

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "metadata": {
    },
  • "pagination": {
    }
}

NGS API

Endpoints related to Next Gen Stats

Get player charts

Returns route charts, pass charts, and carry charts for players

Authorizations:
BearerAuth
query Parameters
count
integer
Default: 12
Example: count=12
season
required
integer
Example: season=2025
week
string
Default: "all"
Example: week=all

Week number or "all"

type
string
Default: "all"
Enum: "all" "route" "pass" "carry"
Example: type=all

Chart type filter

teamId
string
Default: "all"
Example: teamId=all

Team ID or "all"

esbId
string
Default: "all"
Example: esbId=all

Player ESB ID or "all"

Responses

Response Schema: application/json
Array of objects (Chart)
count
integer
offset
integer
total
integer
season
string
teamId
string
type
string
week
string
seasonType
string

Response samples

Content type
application/json
{
  • "charts": [
    ],
  • "count": 0,
  • "offset": 0,
  • "total": 0,
  • "season": "string",
  • "teamId": "string",
  • "type": "string",
  • "week": "string",
  • "seasonType": "string"
}

Get players list for charts

Returns a list of players available in the chart system

Authorizations:
BearerAuth

Responses

Response Schema: application/json
Array of objects

Response samples

Content type
application/json
{
  • "players": [
    ]
}

Get game center overview

Returns detailed game overview including passing zones, rushing stats, receivers, and pass rushers

Authorizations:
BearerAuth
query Parameters
gameId
required
integer
Example: gameId=2025112700

The unique game identifier

Responses

Response Schema: application/json
object (GameScheduleInfo)
object (PassersOverview)
object (RushersOverview)
object (ReceiversOverview)
object (PassRushersOverview)
object (GameLeaders)

Response samples

Content type
application/json
{
  • "schedule": {
    },
  • "passers": {
    },
  • "rushers": {
    },
  • "receivers": {
    },
  • "passRushers": {
    },
  • "leaders": {
    }
}

Get longest plays by distance

Returns leaderboard of longest plays by in-play distance covered

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 20
Example: limit=20
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=2

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (DistanceLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "leaders": [
    ]
}

Get longest tackles

Returns leaderboard of longest distance covered to make a tackle

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 20
Example: limit=20
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=2

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (TackleLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "leaders": [
    ]
}

Get improbable completions

Returns leaderboard of most improbable pass completions based on completion probability

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (CompletionLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "completionLeaders": [
    ]
}

Get remarkable rushes

Returns leaderboard of rush yards over expected

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (ERYLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "eryLeaders": [
    ]
}

Get incredible YAC plays

Returns leaderboard of yards after catch over expectation

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (YACLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "yacLeaders": [
    ]
}

Get fastest ball carriers

Returns leaderboard of fastest ball carrier speeds

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 20
Example: limit=20
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=2

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
Array of objects (SpeedLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "leaders": [
    ]
}

Get fastest sacks

Returns leaderboard of fastest sack times

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 20
Example: limit=20
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=2

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
leagueAverage
number
Array of objects (SackLeaderEntry)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "leagueAverage": 0,
  • "leaders": [
    ]
}

Get full season schedule

Returns the full schedule for a given season

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

The NFL season year

Responses

Response Schema: application/json
Array
gameKey
integer
gameId
integer
gameDate
string
gameTime
string <date-time>
gameTimeEastern
string
gameType
string
Enum: "PRE" "REG" "POST"
season
integer
seasonType
string
week
integer
weekNameAbbr
string
smartId
string
isoTime
integer <int64>
networkChannel
string
ngsGame
boolean
homeTeamId
string
homeTeamAbbr
string
homeDisplayName
string
homeNickname
string
object (TeamInfo)

Basic team information included in roster responses

visitorTeamId
string
visitorTeamAbbr
string
visitorDisplayName
string
visitorNickname
string
object (TeamInfo)

Basic team information included in roster responses

object (Site)
object (Score)
releasedToClubs
boolean
validated
boolean

Response samples

Content type
application/json
[
  • {
    }
]

Get current week schedule

Returns the schedule for the current week of the NFL season

Authorizations:
BearerAuth

Responses

Response Schema: application/json
season
integer
seasonType
string
week
integer
Array of objects (NGSScheduledGame)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "week": 0,
  • "games": [
    ]
}

Get all NFL teams

Returns a list of all NFL teams with their details

Authorizations:
BearerAuth

Responses

Response Schema: application/json
Array
teamId
string
smartId
string
abbr
string
cityState
string
fullName
string
nick
string
logo
string
teamType
string
Enum: "TEAM" "PRO"
conferenceAbbr
string
object (Conference)
object (Division)
stadiumName
string
teamSiteUrl
string or null
teamSiteTicketUrl
string or null
ticketPhoneNumber
string or null
yearFound
integer
season
integer

Response samples

Content type
application/json
[
  • {
    }
]

Get live game scores

Returns live scores for games in a specific week

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
required
integer
Example: week=13

Responses

Response Schema: application/json
season
integer
seasonType
string
week
integer
Array of objects (NGSGameScore)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "week": 0,
  • "scores": [
    ]
}

Get play highlights

Returns highlighted plays from games

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 16
Example: limit=16
season
required
integer
Example: season=2025

Responses

Response Schema: application/json
season
integer
Array of objects (Highlight)
total
integer
count
integer
offset
integer
limit
integer

Response samples

Content type
application/json
{
  • "season": 0,
  • "highlights": [
    ],
  • "total": 0,
  • "count": 0,
  • "offset": 0,
  • "limit": 0
}

Get passing statistics

Returns passing statistics for quarterbacks

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=4

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
filter
string
threshold
integer
Array of objects (PassingStat)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "filter": "string",
  • "threshold": 0,
  • "stats": [
    ]
}

Get receiving statistics

Returns receiving statistics for receivers

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
threshold
integer
Array of objects (ReceivingStat)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "threshold": 0,
  • "stats": [
    ]
}

Get rushing statistics

Returns rushing statistics for ball carriers

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
filter
string
threshold
integer
Array of objects (RushingStat)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "filter": "string",
  • "threshold": 0,
  • "stats": [
    ]
}

Get NGS articles

Returns articles filtered by category.

Note: This endpoint uses a different base URL: https://api.nfl.com

Authorizations:
BearerAuth
query Parameters
category
required
string
Example: category=next-gen-stats-news

Article category slug

limit
integer
Default: 16
Example: limit=16
offset
integer
Default: 0
Example: offset=32

Responses

Response Schema: application/json
Array of objects (ContentItem)
object (ContentMetadata)
object (NGSPagination)

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "metadata": {
    },
  • "pagination": {
    }
}

Get mixed NGS content

Returns mixed content (articles, videos) related to Next Gen Stats.

Note: This endpoint uses a different base URL: https://api.nfl.com

Authorizations:
BearerAuth
query Parameters
limit
integer
Default: 16
Example: limit=16
offset
integer
Default: 0
Example: offset=28

Responses

Response Schema: application/json
Array of objects (ContentItem)
object (ContentMetadata)
object (NGSPagination)

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "metadata": {
    },
  • "pagination": {
    }
}

Get NGS video clips

Returns video clips filtered by video channel.

Note: This endpoint uses a different base URL: https://api.nfl.com

Authorizations:
BearerAuth
query Parameters
videoChannel
required
string
Example: videoChannel=next-gen-stats-vc

Video channel slug

limit
integer
Default: 16
Example: limit=16
offset
integer
Default: 0
Example: offset=32

Responses

Response Schema: application/json
Array of objects (ContentItem)
object (ContentMetadata)
object (NGSPagination)

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "metadata": {
    },
  • "pagination": {
    }
}

Player Passing Statistics

Individual player passing statistics and analytics by week

Get Player Passing Statistics by Week

Retrieves comprehensive passing statistics for NFL players during a specified week and season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified passers, and various sorting options. Data includes completion percentage, yards per attempt, passer rating, EPA (Expected Points Added), CPOE (Completion Percentage Over Expected), time to throw metrics, and game-specific context.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
string
Enum: "WEEK_1" "WEEK_2" "WEEK_3" "WEEK_4" "WEEK_5" "WEEK_6" "WEEK_7" "WEEK_8" "WEEK_9" "WEEK_10" "WEEK_11" "WEEK_12" "WEEK_13" "WEEK_14" "WEEK_15" "WEEK_16" "WEEK_17" "WEEK_18"
Example: week=WEEK_3

Week identifier

limit
integer [ 1 .. 100 ]
Default: 50
Example: limit=50

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "cmp" "att" "yds" "td" "int" "rating" "ypa" "cmpPct" "sack" "xCmp" "cpoe" "db" "epa" "epaDb" "avgTTT" "avgTTP" "avgTTS" "qbp" "qbpR" "blitzR" "drop" "dropR" "ay" "yac" "xYac" "yacPct" "ayAtt" "avgSep" "deepAttPct" "paDbPct" "twAttPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedPasser
boolean
Default: false
Example: qualifiedPasser=false

Filter to only qualified passers (minimum attempts threshold)

teamOffense
Array of strings
Example: teamOffense=3900&teamOffense=3200

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

required
Array of objects (WeeklyPlayerPassingStats)
qualifiedPasser
boolean

Whether results are filtered to qualified passers only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
required
string

Week identifier

Response samples

Content type
application/json
{
  • "limit": 50,
  • "offset": 0,
  • "passers": [
    ],
  • "qualifiedPasser": false,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3200",
  • "total": 1,
  • "week": "WEEK_3"
}

Player Receiving Statistics

Individual player receiving statistics and analytics

Get Player Receiving Statistics by Season

Retrieves comprehensive receiving statistics for NFL players during a specified season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified receivers, and various sorting options. Data includes catch percentage, yards per reception, EPA (Expected Points Added), CROE (Catch Rate Over Expected), target share, route depth, separation metrics, and YAC analytics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=3

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "rt" "tgt" "rec" "yds" "td" "int" "rating" "catch" "xCatch" "croe" "ydsRec" "ydsRt" "epa" "epaTgt" "epaRt" "drop" "yac" "xYac" "yacoe" "yacRec" "avgSep" "ay" "ayTgt" "tgtRt" "avgRtDep" "ezTgt" "ezRec" "deepTgtPct" "twPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedReceiver
boolean
Default: false
Example: qualifiedReceiver=false

Filter to only qualified receivers (minimum target threshold)

teamOffense
Array of strings
Example: teamOffense=3000&teamOffense=3900

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedReceiver
boolean

Whether results are filtered to qualified receivers only

required
Array of objects (PlayerReceivingStats)
season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
string

Week identifier

Response samples

Content type
application/json
{
  • "limit": 50,
  • "offset": 0,
  • "qualifiedReceiver": false,
  • "receivers": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3900",
  • "total": 12,
  • "week": "WEEK_3"
}

Get Player Receiving Statistics by Week

Retrieves comprehensive receiving statistics for NFL players during a specified week and season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified receivers, and various sorting options. Data includes catch percentage, yards per reception, EPA (Expected Points Added), CROE (Catch Rate Over Expected), target share, route depth, separation metrics, and YAC analytics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
string
Enum: "WEEK_1" "WEEK_2" "WEEK_3" "WEEK_4" "WEEK_5" "WEEK_6" "WEEK_7" "WEEK_8" "WEEK_9" "WEEK_10" "WEEK_11" "WEEK_12" "WEEK_13" "WEEK_14" "WEEK_15" "WEEK_16" "WEEK_17" "WEEK_18"
Example: week=WEEK_3

Week identifier

limit
integer [ 1 .. 100 ]
Default: 50
Example: limit=50

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "rt" "tgt" "rec" "yds" "td" "int" "rating" "catch" "xCatch" "croe" "ydsRec" "ydsRt" "epa" "epaTgt" "epaRt" "drop" "yac" "xYac" "yacoe" "yacRec" "avgSep" "ay" "ayTgt" "tgtRt" "avgRtDep" "ezTgt" "ezRec" "deepTgtPct" "twPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedReceiver
boolean
Default: false
Example: qualifiedReceiver=false

Filter to only qualified receivers (minimum target threshold)

teamOffense
Array of strings
Example: teamOffense=3900&teamOffense=3200

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedReceiver
boolean

Whether results are filtered to qualified receivers only

required
Array of objects (PlayerReceivingStats)
season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
string

Week identifier

Response samples

Content type
application/json
{
  • "limit": 50,
  • "offset": 0,
  • "qualifiedReceiver": false,
  • "receivers": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3900",
  • "total": 12,
  • "week": "WEEK_3"
}

Player Rushing Statistics

Individual player rushing statistics and analytics

Get Player Rushing Statistics by Season

Retrieves comprehensive rushing statistics for NFL players during a specified season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified rushers, and various sorting options. Data includes yards per carry, EPA (Expected Points Added), RYOE (Rush Yards Over Expected), efficiency metrics, yards before/after contact, and situational breakdowns.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=3

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "att" "yds" "td" "ypc" "epa" "epaAtt" "xRy" "xYpc" "ryoe" "ryoeAtt" "yaco" "yacoAtt" "ybco" "success" "fum" "lost" "rush10PYds" "rush15PMph" "rush20PMph" "eff" "inTPct" "stBoxPct" "underPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedRusher
boolean
Default: false
Example: qualifiedRusher=false

Filter to only qualified rushers (minimum attempts threshold)

teamOffense
Array of strings
Example: teamOffense=3000&teamOffense=3900

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedRusher
boolean

Whether results are filtered to qualified rushers only

required
Array of objects (PlayerRushingStats)
season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "limit": 3,
  • "offset": 0,
  • "qualifiedRusher": false,
  • "rushers": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3000",
  • "total": 7
}

Get Player Rushing Statistics by Week

Retrieves comprehensive rushing statistics for NFL players during a specified week and season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified rushers, and various sorting options. Data includes yards per carry, EPA (Expected Points Added), RYOE (Rush Yards Over Expected), efficiency metrics, yards before/after contact, and game-specific context.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
string
Enum: "WEEK_1" "WEEK_2" "WEEK_3" "WEEK_4" "WEEK_5" "WEEK_6" "WEEK_7" "WEEK_8" "WEEK_9" "WEEK_10" "WEEK_11" "WEEK_12" "WEEK_13" "WEEK_14" "WEEK_15" "WEEK_16" "WEEK_17" "WEEK_18"
Example: week=WEEK_3

Week identifier

limit
integer [ 1 .. 100 ]
Default: 50
Example: limit=50

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "att" "yds" "td" "ypc" "epa" "epaAtt" "xRy" "xYpc" "ryoe" "ryoeAtt" "yaco" "yacoAtt" "ybco" "success" "fum" "lost" "rush10PYds" "rush15PMph" "rush20PMph" "eff" "inTPct" "stBoxPct" "underPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedRusher
boolean
Default: false
Example: qualifiedRusher=false

Filter to only qualified rushers (minimum attempts threshold)

teamOffense
Array of strings
Example: teamOffense=3900&teamOffense=3200

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedRusher
boolean

Whether results are filtered to qualified rushers only

required
Array of objects (WeeklyPlayerRushingStats)
season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
required
string

Week identifier

Response samples

Content type
application/json
{
  • "limit": 50,
  • "offset": 0,
  • "qualifiedRusher": false,
  • "rushers": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3200",
  • "total": 4,
  • "week": "WEEK_3"
}

Player Statistics

Individual player passing statistics and analytics

Get Player Passing Statistics by Season

Retrieves comprehensive passing statistics for NFL players during a specified season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified passers only, and various sorting options. Data includes completion percentage, yards per attempt, passer rating, EPA (Expected Points Added), CPOE (Completion Percentage Over Expected), time to throw metrics, and situational statistics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "yds" "att" "cmp" "td" "int" "rating" "ypa" "cmpPct" "sack" "epa" "epaDb" "avgTTT" "avgTTP" "qbpR" "blitzR" "dropR" "ay" "yac" "avgSep" "deepAttPct" "paDbPct" "twAttPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedPasser
boolean
Default: true
Example: qualifiedPasser=true

Filter to only qualified passers (minimum attempts threshold)

teamOffense
Array of strings
Example: teamOffense=3000&teamOffense=3900

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

required
Array of objects (PlayerPassingStats)
qualifiedPasser
boolean

Whether results are filtered to qualified passers only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "limit": 35,
  • "offset": 0,
  • "passers": [
    ],
  • "qualifiedPasser": true,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "total": 31
}

Players

Player information, statistics, and projections

Get Player Details

Retrieves detailed information about a specific NFL player including physical attributes, team information, draft details, and current status.

Authorizations:
BearerAuth
query Parameters
nflId
required
integer
Example: nflId=54517

NFL player identifier

Responses

Response Schema: application/json
birthDate
string <date>

Player's birth date

collegeConference
string

Player's college conference

collegeName
string

Player's college

currentTeamId
string

Current team identifier

displayName
string

Player's display name

draftClub
string or null

Team that drafted the player

draftNumber
integer or null

Overall draft pick number

draftround
integer or null

Draft round

entryYear
integer

Year player entered the league

esbId
string

ESB identifier

firstName
string

Player's first name

footballName
string

Player's football name (nickname)

gsisId
string

GSIS identifier

gsisItId
integer

GSIS IT identifier

headshot
string <uri>

URL to player headshot image

height
string

Player height (format is feet-inches)

jerseyNumber
integer

Player's jersey number

lastName
string

Player's last name

nflId
integer

NFL player identifier

ngsPosition
string or null

Next Gen Stats position

ngsPositionGroup
string or null

Next Gen Stats position group

position
string

Player's position

positionGroup
string

Player's position group

rookieYear
integer

Player's rookie year

season
integer

Current season

shortName
string

Shortened player name

smartId
string <uuid>

Smart identifier for the player

status
string

Player status code

statusDescriptionAbbr
string

Abbreviated status description

statusShortDescription
string

Short status description

teamAbbr
string

Current team abbreviation

uniformNumber
string

Player's uniform number (formatted)

weight
integer

Player weight in pounds

yearsOfExperience
integer

Years of NFL experience

Array of objects (Award)
biography
string

Player biography

object (CareerStats)
object (ContractInfo)
object (SeasonStats)

Response samples

Content type
application/json
{
  • "birthDate": "2019-08-24",
  • "collegeConference": "Southeastern Conference",
  • "collegeName": "Louisiana State",
  • "currentTeamId": "string",
  • "displayName": "Justin Jefferson",
  • "draftClub": "string",
  • "draftNumber": 0,
  • "draftround": 0,
  • "entryYear": 0,
  • "esbId": "string",
  • "firstName": "string",
  • "footballName": "string",
  • "gsisId": "string",
  • "gsisItId": 0,
  • "headshot": "http://example.com",
  • "height": "6-3",
  • "jerseyNumber": 0,
  • "lastName": "string",
  • "nflId": 52430,
  • "ngsPosition": "string",
  • "ngsPositionGroup": "string",
  • "position": "WR",
  • "positionGroup": "WR",
  • "rookieYear": 0,
  • "season": 0,
  • "shortName": "J.Jefferson",
  • "smartId": "884e3ef1-4039-4f0d-913c-7988cf03848f",
  • "status": "ACT",
  • "statusDescriptionAbbr": "A01",
  • "statusShortDescription": "Active",
  • "teamAbbr": "string",
  • "uniformNumber": "18",
  • "weight": 0,
  • "yearsOfExperience": 0,
  • "awards": [
    ],
  • "biography": "string",
  • "careerStats": {
    },
  • "contractInfo": {
    },
  • "currentSeasonStats": {
    }
}

Get Projected Player Statistics

Retrieves projected fantasy statistics for players based on team, season, and week. Returns data in JSON:API format with relationships between players and their projected stats.

Authorizations:
BearerAuth
query Parameters
filter[nflTeamId]
string <uuid>
Example: filter[nflTeamId]=10403000-5851-f9d5-da45-78365a05b6b0

Filter by NFL team ID (UUID format)

season
required
integer
Example: season=2025

Season year

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

page[size]
integer [ 1 .. 100 ]
Default: 20

Number of results per page

Responses

Response Schema: application/json
required
Array of objects (PlayerProjection)

Primary player data with relationships

required
Array of PlayerWeekProjectedPoints (object) or PlayerWeekProjectedStats (object)

Related data included in response

object
object

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "included": [
    ],
  • "meta": {
    },
  • "pagination": {
    }
}

Search Players

Searches for NFL players by name or term. Returns a list of players matching the search criteria including both active and retired players.

Authorizations:
BearerAuth
query Parameters
term
required
string
Example: term=Pickens

Search term for player name (first or last name)

Responses

Response Schema: application/json
required
Array of objects (PlayerSearchResult)

Array of players matching search criteria

term
required
string

Search term used

Response samples

Content type
application/json
{
  • "players": [
    ],
  • "term": "Pickens"
}

Plays

Play-by-play data and film room analysis

Get Play Summary

Retrieves detailed information about a specific play in a game including play description, statistics, involved players, win probability, and expected points.

Authorizations:
BearerAuth
query Parameters
gameId
required
string <uuid>
Example: gameId=f665fc10-311e-11f0-b670-ae1250fadad1

Game identifier (UUID format)

playId
required
integer
Example: playId=40

Play identifier within the game

Responses

Response Schema: application/json
Array of objects (PlayPlayer)

Away team players involved in the play

gameId
required
integer

Game identifier in integer format

gameKey
integer

Unique game key

gsisPlayId
integer

GSIS play identifier

Array of objects (PlayPlayer)

Home team players involved in the play

homeIsOffense
boolean

Whether home team has offensive possession

required
object (PlayDetail)
playId
required
integer

Play identifier

required
object (GameSchedule)

Response samples

Content type
application/json
{
  • "away": [
    ],
  • "gameId": 2025092104,
  • "gameKey": 59880,
  • "gsisPlayId": 0,
  • "home": [
    ],
  • "homeIsOffense": true,
  • "play": {
    },
  • "playId": 0,
  • "schedule": {
    }
}

Pro API

Endpoints provided by NFL Pro

Get Game Preview Content

Retrieves preview content and insights for a specific game based on teams and week. Returns preview information, matchup analysis, and key storylines.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer
Example: week=4

Week number

visitorDisplayName
required
string
Example: visitorDisplayName=Minnesota Vikings

Visiting team display name

homeDisplayName
required
string
Example: homeDisplayName=Pittsburgh Steelers

Home team display name

Responses

Response Schema: application/json
preview
object or null

Preview content and analysis

Response samples

Content type
application/json
{
  • "preview": { }
}

Get Home Film Cards

Retrieves featured film room content cards for the home page. Returns weekly playlists and featured player film breakdowns.

Authorizations:
BearerAuth

Responses

Response Schema: application/json
required
Array of objects (FilmCard)
title
required
string

Title of the film card collection

Response samples

Content type
application/json
{
  • "cards": [
    ],
  • "title": "Week 3 Playlists"
}

Get Game-Specific Insights

Retrieves analytical insights and advanced statistics for a specific game. Can filter by tags and exclude specific content types.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

limit
integer [ 1 .. 100 ]
Default: 20
Example: limit=100

Maximum number of insights to return

tags
string
Example: tags=pro-preview

Comma-separated list of tags to filter by

excludeTags
string
Example: excludeTags=betting

Comma-separated list of tags to exclude

fapiGameId
required
string <uuid>
Example: fapiGameId=f688dfde-311e-11f0-b670-ae1250fadad1

FAPI Game identifier (UUID)

awayTeamId
required
string
Example: awayTeamId=3000

Away team identifier

homeTeamId
required
string
Example: homeTeamId=3900

Home team identifier

Responses

Response Schema: application/json
Array
content
object

Insight content and analysis

gameId
string

Game identifier

id
string

Insight identifier

type
string

Type of insight

Response samples

Content type
application/json
[
  • {
    }
]

Get Season Content Insights

Retrieves curated editorial insights and analytics content for NFL players during a specified season. Returns expert commentary combining Next Gen Stats data with editorial analysis, including pregame previews, postgame breakdowns, fantasy insights, and evergreen content. Supports filtering by player, team, content tags, and publication limits for targeted content discovery.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

limit
integer [ 1 .. 100 ]
Default: 20
Example: limit=60

Maximum number of insights to return

tags
Array of strings
Items Enum: "nfl-pro" "editorial" "next-gen-stats" "pregame" "postgame" "fantasy" "pro-preview" "pro-matchup" "evergreen"
Example: tags=nfl-pro

Content tags to filter by (supports multiple comma-separated tags)

teamId
string
Example: teamId=3900

Filter by specific team identifier

nflId
string
Example: nflId=46101

Filter by specific player NFL identifier

Responses

Response Schema: application/json
Array
createdAt
required
string <date-time>

Content creation timestamp

createdBy
required
string

Content creator identifier

date
required
string <date>

Content publication date

esbId
string

ESB player identifier

evergreen
required
boolean
Default: false

Whether content is evergreen (timeless) or time-sensitive

gameId
integer or null

Game identifier (10-digit format YYYYMMDDNN)

gsisId
string

GSIS player identifier

headshot
string <uri>

URL to player headshot image (contains formatInstructions placeholder)

id
required
string

Unique content identifier

imageUrl
string or null <uri>

Associated image or chart URL (optional)

jerseyNumber
integer

Player's jersey number

nflId
required
integer

NFL player identifier

playerName
required
string

Player's full name

position
required
string
Enum: "QB" "RB" "WR" "TE" "OL" "DL" "LB" "DB" "K" "P"

Player position

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

secondTeamAbbr
string or null

Opponent or related team abbreviation

secondTeamId
string or null

Opponent or related team identifier

secondTeamType
string or null
Enum: "offense" "defense"

Context of the second team (typically "defense" for opponent)

smartId
string <uuid>

Smart player identifier

subNote1
string

Detailed insight content and analysis

tags
required
Array of strings

Content classification tags

teamAbbr
required
string

Player's team abbreviation

teamId
required
string

Player's team identifier

title
required
string

Main insight headline or title

updatedAt
required
string <date-time>

Last update timestamp

updatedBy
required
string

Last editor identifier

week
required
integer

Week number (if applicable)

Response samples

Content type
application/json
[
  • {
    }
]

Get Player Details

Retrieves detailed information about a specific NFL player including physical attributes, team information, draft details, and current status.

Authorizations:
BearerAuth
query Parameters
nflId
required
integer
Example: nflId=54517

NFL player identifier

Responses

Response Schema: application/json
birthDate
string <date>

Player's birth date

collegeConference
string

Player's college conference

collegeName
string

Player's college

currentTeamId
string

Current team identifier

displayName
string

Player's display name

draftClub
string or null

Team that drafted the player

draftNumber
integer or null

Overall draft pick number

draftround
integer or null

Draft round

entryYear
integer

Year player entered the league

esbId
string

ESB identifier

firstName
string

Player's first name

footballName
string

Player's football name (nickname)

gsisId
string

GSIS identifier

gsisItId
integer

GSIS IT identifier

headshot
string <uri>

URL to player headshot image

height
string

Player height (format is feet-inches)

jerseyNumber
integer

Player's jersey number

lastName
string

Player's last name

nflId
integer

NFL player identifier

ngsPosition
string or null

Next Gen Stats position

ngsPositionGroup
string or null

Next Gen Stats position group

position
string

Player's position

positionGroup
string

Player's position group

rookieYear
integer

Player's rookie year

season
integer

Current season

shortName
string

Shortened player name

smartId
string <uuid>

Smart identifier for the player

status
string

Player status code

statusDescriptionAbbr
string

Abbreviated status description

statusShortDescription
string

Short status description

teamAbbr
string

Current team abbreviation

uniformNumber
string

Player's uniform number (formatted)

weight
integer

Player weight in pounds

yearsOfExperience
integer

Years of NFL experience

Array of objects (Award)
biography
string

Player biography

object (CareerStats)
object (ContractInfo)
object (SeasonStats)

Response samples

Content type
application/json
{
  • "birthDate": "2019-08-24",
  • "collegeConference": "Southeastern Conference",
  • "collegeName": "Louisiana State",
  • "currentTeamId": "string",
  • "displayName": "Justin Jefferson",
  • "draftClub": "string",
  • "draftNumber": 0,
  • "draftround": 0,
  • "entryYear": 0,
  • "esbId": "string",
  • "firstName": "string",
  • "footballName": "string",
  • "gsisId": "string",
  • "gsisItId": 0,
  • "headshot": "http://example.com",
  • "height": "6-3",
  • "jerseyNumber": 0,
  • "lastName": "string",
  • "nflId": 52430,
  • "ngsPosition": "string",
  • "ngsPositionGroup": "string",
  • "position": "WR",
  • "positionGroup": "WR",
  • "rookieYear": 0,
  • "season": 0,
  • "shortName": "J.Jefferson",
  • "smartId": "884e3ef1-4039-4f0d-913c-7988cf03848f",
  • "status": "ACT",
  • "statusDescriptionAbbr": "A01",
  • "statusShortDescription": "Active",
  • "teamAbbr": "string",
  • "uniformNumber": "18",
  • "weight": 0,
  • "yearsOfExperience": 0,
  • "awards": [
    ],
  • "biography": "string",
  • "careerStats": {
    },
  • "contractInfo": {
    },
  • "currentSeasonStats": {
    }
}

Get Projected Player Statistics

Retrieves projected fantasy statistics for players based on team, season, and week. Returns data in JSON:API format with relationships between players and their projected stats.

Authorizations:
BearerAuth
query Parameters
filter[nflTeamId]
string <uuid>
Example: filter[nflTeamId]=10403000-5851-f9d5-da45-78365a05b6b0

Filter by NFL team ID (UUID format)

season
required
integer
Example: season=2025

Season year

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

page[size]
integer [ 1 .. 100 ]
Default: 20

Number of results per page

Responses

Response Schema: application/json
required
Array of objects (PlayerProjection)

Primary player data with relationships

required
Array of PlayerWeekProjectedPoints (object) or PlayerWeekProjectedStats (object)

Related data included in response

object
object

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "included": [
    ],
  • "meta": {
    },
  • "pagination": {
    }
}

Search Players

Searches for NFL players by name or term. Returns a list of players matching the search criteria including both active and retired players.

Authorizations:
BearerAuth
query Parameters
term
required
string
Example: term=Pickens

Search term for player name (first or last name)

Responses

Response Schema: application/json
required
Array of objects (PlayerSearchResult)

Array of players matching search criteria

term
required
string

Search term used

Response samples

Content type
application/json
{
  • "players": [
    ],
  • "term": "Pickens"
}

Get Play Summary

Retrieves detailed information about a specific play in a game including play description, statistics, involved players, win probability, and expected points.

Authorizations:
BearerAuth
query Parameters
gameId
required
string <uuid>
Example: gameId=f665fc10-311e-11f0-b670-ae1250fadad1

Game identifier (UUID format)

playId
required
integer
Example: playId=40

Play identifier within the game

Responses

Response Schema: application/json
Array of objects (PlayPlayer)

Away team players involved in the play

gameId
required
integer

Game identifier in integer format

gameKey
integer

Unique game key

gsisPlayId
integer

GSIS play identifier

Array of objects (PlayPlayer)

Home team players involved in the play

homeIsOffense
boolean

Whether home team has offensive possession

required
object (PlayDetail)
playId
required
integer

Play identifier

required
object (GameSchedule)

Response samples

Content type
application/json
{
  • "away": [
    ],
  • "gameId": 2025092104,
  • "gameKey": 59880,
  • "gsisPlayId": 0,
  • "home": [
    ],
  • "homeIsOffense": true,
  • "play": {
    },
  • "playId": 0,
  • "schedule": {
    }
}

Get Current Week Games

Retrieves all games for the current week of the NFL season. Returns comprehensive game data including teams, venues, broadcast information, scores (for completed games), and ticket details. The endpoint automatically determines the current week based on the current date.

Authorizations:
BearerAuth

Responses

Response Schema: application/json
Array of objects (CurrentGame)
gamesPlayedSmartIds
Array of strings <uuid> [ items <uuid > ]

Smart IDs of games already played

numberOfGames
integer

Total number of games in the week

numberOfGamesPlayed
integer

Number of games already played

season
integer

Current season year

seasonType
string
Enum: "PRE" "REG" "POST"

Current season type

week
integer

Current week number

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "gamesPlayedSmartIds": [
    ],
  • "numberOfGames": 0,
  • "numberOfGamesPlayed": 0,
  • "season": 2025,
  • "seasonType": "PRE",
  • "week": 0
}

Get Single Game Details

Retrieves detailed information for a specific game by its ID. Returns comprehensive game data including teams, score, venue, broadcast information, and current game status.

Authorizations:
BearerAuth
query Parameters
gameId
required
string <uuid>
Example: gameId=f665fc10-311e-11f0-b670-ae1250fadad1

Game identifier (UUID format)

Responses

Response Schema: application/json
gameDate
string
gameId
integer
gameKey
integer
gameTime
string <date-time>
gameTimeEastern
string
gameType
string
Enum: "PRE" "REG" "POST"
homeDisplayName
string
homeNickname
string
object (TeamInfo)

Basic team information included in roster responses

homeTeamAbbr
string
homeTeamId
string
isoTime
integer

Unix timestamp in milliseconds

networkChannel
string
ngsGame
boolean
releasedToClubs
boolean
object (GameScore)
season
integer
seasonType
string
Enum: "PRE" "REG" "POST"
object (Site)
smartId
string <uuid>
validated
boolean
visitorDisplayName
string
visitorNickname
string
object (TeamInfo)

Basic team information included in roster responses

visitorTeamAbbr
string
visitorTeamId
string
week
integer
weekNameAbbr
string

Response samples

Content type
application/json
{
  • "gameDate": "09/21/2025",
  • "gameId": 0,
  • "gameKey": 0,
  • "gameTime": "2019-08-24T14:15:22Z",
  • "gameTimeEastern": "string",
  • "gameType": "PRE",
  • "homeDisplayName": "string",
  • "homeNickname": "string",
  • "homeTeam": {
    },
  • "homeTeamAbbr": "string",
  • "homeTeamId": "string",
  • "isoTime": 0,
  • "networkChannel": "string",
  • "ngsGame": true,
  • "releasedToClubs": true,
  • "score": {
    },
  • "season": 0,
  • "seasonType": "PRE",
  • "site": {
    },
  • "smartId": "884e3ef1-4039-4f0d-913c-7988cf03848f",
  • "validated": true,
  • "visitorDisplayName": "string",
  • "visitorNickname": "string",
  • "visitorTeam": {
    },
  • "visitorTeamAbbr": "string",
  • "visitorTeamId": "string",
  • "week": 0,
  • "weekNameAbbr": "string"
}

Get Game Matchup Rankings

Retrieves comprehensive matchup rankings and statistical comparisons for both teams in a specific game. Returns offensive, defensive, and special teams rankings with Z-scores and advantage ratings for various statistical categories.

Authorizations:
BearerAuth
query Parameters
gameId
required
string^\d{10}$
Example: gameId=2025092500

Game identifier (10-digit format YYYYMMDDNN)

Responses

Response Schema: application/json
gameId
integer
gameKey
integer
object (TeamMatchupRankings)

Comprehensive team rankings across multiple statistical categories

season
integer
seasonType
string
Enum: "PRE" "REG" "POST"
object (TeamMatchupRankings)

Comprehensive team rankings across multiple statistical categories

week
integer

Response samples

Content type
application/json
{
  • "gameId": 2025092500,
  • "gameKey": 0,
  • "homeTeamMatchupRankings": {
    },
  • "season": 0,
  • "seasonType": "PRE",
  • "visitorTeamMatchupRankings": {
    },
  • "week": 0
}

Get Team Injuries for Game Week

Retrieves injury report information for a specific team in a given week. Returns player injury status and details for the specified team and week.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

teamId
required
string <uuid>
Example: teamId=10403000-5851-f9d5-da45-78365a05b6b0

Team identifier (UUID format)

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

Responses

Response Schema: application/json
Array of objects (TeamInjuryReport)
season
integer
week
integer

Response samples

Content type
application/json
{
  • "reports": [
    ],
  • "season": 0,
  • "week": 0
}

Get Games by Week

Retrieves all games for a specific season, season type, and week. Returns comprehensive game data including teams, venues, broadcast information, and ticket details for all games in the specified week.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=3

Week number within the season

Responses

Response Schema: application/json
Array of objects (Game)
season
string

Season year

seasonType
string
Enum: "PRE" "REG" "POST"

Type of season

week
string

Week number

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "season": "2025",
  • "seasonType": "REG",
  • "week": "3"
}

Get Future Betting Odds

Retrieves comprehensive betting futures data including Super Bowl odds, conference championship odds, and division winner odds for all teams. Returns decimal odds for each selection along with availability status. This endpoint provides futures market data across multiple betting hierarchies.

Authorizations:
BearerAuth

Responses

Response Schema: application/json
object

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Team Standings

Retrieves comprehensive team standings for a specific season, season type, and week. Returns detailed standings information including division, conference, home/away records, win percentages, points for/against, current streaks, and clinching scenarios. Standings are calculated through the specified week.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

Responses

Response Schema: application/json
object (Pagination)
season
integer
seasonType
string
Enum: "PRE" "REG" "POST"
week
integer

Current week for standings

Array of objects

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "season": 0,
  • "seasonType": "PRE",
  • "week": 0,
  • "weeks": [
    ]
}

Get Weekly Betting Odds

Retrieves comprehensive betting odds for all games in a specified week. Returns point spreads, money lines, and totals (over/under) for each game with the latest odds updates from betting markets.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

Responses

Response Schema: application/json
Array of objects (GameOdds)
season
string

Season year

seasonType
string
Enum: "PRE" "REG" "POST"

Type of season

week
string

Week number

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "season": "2025",
  • "seasonType": "REG",
  • "week": "4"
}

Get Season Weeks

Retrieves all weeks for a specific season including preseason, regular season, and postseason weeks. Returns week dates, types, and teams on bye for each week. This endpoint provides a comprehensive season calendar with all scheduling information.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

Responses

Response Schema: application/json
object (Pagination)
season
string

Season year

Array of objects (Week)

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "season": "2025",
  • "weeks": [
    ]
}

Get Live Game Scores

Retrieves real-time scores and game status for all games in a specified week. This endpoint updates frequently (15-second cache) to provide live scoring updates during active games. Returns an empty array when no games are currently being played.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number

Responses

Response Schema: application/json
required
Array of objects (LiveGame)

Array of live game data (empty when no games are active)

season
required
string

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

week
required
string

Week number

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "season": "2025",
  • "seasonType": "REG",
  • "week": "4"
}

Get Game Win Probability by Plays

Retrieves comprehensive win probability data for every play in specified games. Returns pre-game win probabilities and detailed play-by-play probability changes, including Win Probability Added (WPA) metrics for each play. This advanced analytics endpoint tracks how each play impacts the probability of each team winning the game. Supports querying multiple games simultaneously.

Authorizations:
BearerAuth
query Parameters
required
string or Array of strings
Examples:
  • gameId=2025092800&gameId=2025092104 - Multiple games
  • gameId=2025092800 - Single game

Game identifier(s) in 10-digit format (YYYYMMDDNN). Can be a single game ID or multiple game IDs for batch retrieval.

Responses

Response Schema: application/json
One of
gameId
required
integer

Game identifier (10-digit format YYYYMMDDNN)

gameKey
required
integer

Unique game key identifier

required
Array of objects (PlayWinProbability)

Chronological list of all plays with win probability data

pregameAwayTeamWinProbability
required
number <float> [ 0 .. 1 ]

Away team's win probability before the game started

pregameHomeTeamWinProbability
required
number <float> [ 0 .. 1 ]

Home team's win probability before the game started

Response samples

Content type
application/json
[ ]

Get Minimal Win Probability Data

Retrieves minimal win probability data for specified games, including pregame win probabilities and play-by-play probability changes throughout the game. This endpoint provides essential win probability metrics with optimized data structure for performance. Supports multiple games in a single request.

Authorizations:
BearerAuth
query Parameters
fapiGameId
required
Array of strings <uuid> [ 1 .. 50 ] items [ items <uuid > ]
Example: fapiGameId=f666051f-311e-11f0-b670-ae1250fadad1&fapiGameId=f6660056-311e-11f0-b670-ae1250fadad1&fapiGameId=f665fc10-311e-11f0-b670-ae1250fadad1

Football API game identifiers (UUID format). Supports multiple game IDs to retrieve win probability data for multiple games simultaneously.

Responses

Response Schema: application/json
gameId
required
integer

Game identifier (10-digit format YYYYMMDDNN)

gameKey
required
integer

Unique game key identifier

required
Array of objects (PlayWinProbability)

Chronological list of all plays with win probability data

pregameAwayTeamWinProbability
required
number <float> [ 0 .. 1 ]

Away team's win probability before the game started

pregameHomeTeamWinProbability
required
number <float> [ 0 .. 1 ]

Home team's win probability before the game started

Response samples

Content type
application/json
{
  • "gameId": 2025092106,
  • "gameKey": 59882,
  • "plays": [
    ],
  • "pregameAwayTeamWinProbability": 0.28824037592858076,
  • "pregameHomeTeamWinProbability": 0.7117596240714192
}

Get Defensive Player Statistics by Season

Retrieves comprehensive defensive statistics for NFL players during a specified season. Returns detailed coverage metrics including targets allowed, completion rates, pass rating allowed, yards after catch prevention, and advanced Next Gen Stats data. Supports filtering by qualified defenders, teams, and various sorting options. Data includes traditional defensive stats and advanced analytics like EPA (Expected Points Added), CROE (Completion Rate Over Expected), receiver separation allowed, and coverage snap counts.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "cov"
Enum: "cov" "covNd" "tgtNd" "recNd" "recYdsNd" "recTdNd" "int" "passRatingNd" "tgtEpaNd" "catchNd" "croeNd" "bhPct" "sep" "twfPct" "yacprNd" "tgtRNd"
Example: sortKey=cov

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedDefender
boolean
Default: false
Example: qualifiedDefender=false

Filter to only qualified defenders (minimum snap threshold)

teamDefense
Array of strings
Example: teamDefense=3800&teamDefense=1800

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
required
Array of objects (DefensivePlayerStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedDefender
boolean

Whether results are filtered to qualified defenders only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "defenders": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "qualifiedDefender": false,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "cov",
  • "sortValue": "DESC",
  • "total": 730
}

Get Defensive Player Overview Statistics by Season

Retrieves comprehensive defensive overview statistics for NFL players during a specified season. Returns detailed metrics including traditional defensive stats (tackles, stops, sacks), coverage metrics (targets, completions allowed, pass rating allowed), pass rush data, and advanced analytics. Supports filtering by qualified defenders, teams, and various sorting options. Data includes snap counts, tackle efficiency, coverage effectiveness, and situational performance.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=3

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "snap"
Enum: "snap" "rd" "pr" "tck" "tStop" "hStop" "qbp" "qbpR" "sack" "tgtNd" "recNd" "recYdsNd" "recTdNd" "int" "passRatingNd" "gameSnap" "snapPct"
Example: sortKey=sack

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedDefender
boolean
Default: false
Example: qualifiedDefender=false

Filter to only qualified defenders (minimum snap threshold)

teamDefense
Array of strings
Example: teamDefense=3000&teamDefense=3900

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
required
Array of objects (DefensivePlayerOverviewStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedDefender
boolean

Whether results are filtered to qualified defenders only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamDefense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "defenders": [
    ],
  • "limit": 3,
  • "offset": 0,
  • "qualifiedDefender": false,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamDefense": "3900",
  • "total": 26
}

Get Defensive Pass Rush Statistics by Season

Retrieves comprehensive pass rush statistics for NFL defensive players during a specified season. Returns detailed metrics including pressures, sacks, quarterback hits, time to throw allowed, pass rush productivity, and Next Gen Stats data. Supports filtering by qualified defenders, teams, and various sorting options. Data includes traditional pass rush stats and advanced analytics like pass rush grade, pressure rate, and time to sack metrics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "pr"
Enum: "pr" "prR" "qbp" "qbpR" "ttp" "qp" "sack" "sackR" "tts" "prGo" "turnQbp" "gameSnap"
Example: sortKey=pr

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedDefender
boolean
Default: false
Example: qualifiedDefender=false

Filter to only qualified defenders (minimum snap threshold)

Responses

Response Schema: application/json
required
Array of objects (DefensivePassRushStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedDefender
boolean

Whether results are filtered to qualified defenders only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "defenders": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "qualifiedDefender": false,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "pr",
  • "sortValue": "DESC",
  • "total": 730
}

Get Fantasy Football Statistics by Season

Retrieves comprehensive fantasy football statistics for NFL players during a specified season. Returns fantasy-relevant metrics including standard scoring, PPR scoring, snap counts, and target share data. Supports filtering by position groups (QB, RB, WR, TE, SPEC), teams, minimum offensive snap thresholds, and rolling N-week windows for recent performance analysis. Data includes traditional fantasy categories and advanced metrics for lineup optimization.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "fpStd"
Enum: "fpStd" "fpPpr" "fpHalfPpr" "passYds" "passTd" "passInt" "rushYds" "rushTd" "recYds" "recTd" "rec" "tgt" "snapPct" "targetShare" "redZoneTargets"
Example: sortKey=fpStd

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

positionGroup
Array of strings
Items Enum: "QB" "RB" "WR" "TE" "SPEC"
Example: positionGroup=QB

Filter by position groups (supports multiple positions)

teamOffense
string
Example: teamOffense=3900

Filter by specific offensive team ID

teamDefense
string
Example: teamDefense=4600

Filter by specific defensive team ID (opponent analysis)

minOffensiveSnaps
integer >= 0
Default: 0
Example: minOffensiveSnaps=75

Minimum offensive snaps threshold for inclusion

lastNWeeks
integer [ 1 .. 18 ]
Example: lastNWeeks=3

Number of recent weeks to analyze (rolling window)

Responses

Response Schema: application/json
lastNWeeks
integer

Number of recent weeks analyzed (if applied)

limit
required
integer

Maximum number of results returned

minOffensiveSnaps
integer

Minimum offensive snaps filter applied

offset
required
integer

Number of records skipped

required
Array of objects (FantasyPlayerStats)
positionGroup
Array of strings

Position groups included in results

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Offensive team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
Array of strings

Specific weeks included in analysis

Response samples

Content type
application/json
{
  • "lastNWeeks": 3,
  • "limit": 35,
  • "minOffensiveSnaps": 75,
  • "offset": 0,
  • "players": [
    ],
  • "positionGroup": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "fpStd",
  • "sortValue": "DESC",
  • "teamOffense": "3900",
  • "total": 0,
  • "week": [
    ]
}

Get Player Passing Statistics by Season

Retrieves comprehensive passing statistics for NFL players during a specified season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified passers only, and various sorting options. Data includes completion percentage, yards per attempt, passer rating, EPA (Expected Points Added), CPOE (Completion Percentage Over Expected), time to throw metrics, and situational statistics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "yds" "att" "cmp" "td" "int" "rating" "ypa" "cmpPct" "sack" "epa" "epaDb" "avgTTT" "avgTTP" "qbpR" "blitzR" "dropR" "ay" "yac" "avgSep" "deepAttPct" "paDbPct" "twAttPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedPasser
boolean
Default: true
Example: qualifiedPasser=true

Filter to only qualified passers (minimum attempts threshold)

teamOffense
Array of strings
Example: teamOffense=3000&teamOffense=3900

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

required
Array of objects (PlayerPassingStats)
qualifiedPasser
boolean

Whether results are filtered to qualified passers only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "limit": 35,
  • "offset": 0,
  • "passers": [
    ],
  • "qualifiedPasser": true,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "total": 31
}

Get Player Passing Statistics by Week

Retrieves comprehensive passing statistics for NFL players during a specified week and season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified passers, and various sorting options. Data includes completion percentage, yards per attempt, passer rating, EPA (Expected Points Added), CPOE (Completion Percentage Over Expected), time to throw metrics, and game-specific context.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
string
Enum: "WEEK_1" "WEEK_2" "WEEK_3" "WEEK_4" "WEEK_5" "WEEK_6" "WEEK_7" "WEEK_8" "WEEK_9" "WEEK_10" "WEEK_11" "WEEK_12" "WEEK_13" "WEEK_14" "WEEK_15" "WEEK_16" "WEEK_17" "WEEK_18"
Example: week=WEEK_3

Week identifier

limit
integer [ 1 .. 100 ]
Default: 50
Example: limit=50

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "cmp" "att" "yds" "td" "int" "rating" "ypa" "cmpPct" "sack" "xCmp" "cpoe" "db" "epa" "epaDb" "avgTTT" "avgTTP" "avgTTS" "qbp" "qbpR" "blitzR" "drop" "dropR" "ay" "yac" "xYac" "yacPct" "ayAtt" "avgSep" "deepAttPct" "paDbPct" "twAttPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedPasser
boolean
Default: false
Example: qualifiedPasser=false

Filter to only qualified passers (minimum attempts threshold)

teamOffense
Array of strings
Example: teamOffense=3900&teamOffense=3200

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

required
Array of objects (WeeklyPlayerPassingStats)
qualifiedPasser
boolean

Whether results are filtered to qualified passers only

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
required
string

Week identifier

Response samples

Content type
application/json
{
  • "limit": 50,
  • "offset": 0,
  • "passers": [
    ],
  • "qualifiedPasser": false,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3200",
  • "total": 1,
  • "week": "WEEK_3"
}

Get Player Receiving Statistics by Season

Retrieves comprehensive receiving statistics for NFL players during a specified season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified receivers, and various sorting options. Data includes catch percentage, yards per reception, EPA (Expected Points Added), CROE (Catch Rate Over Expected), target share, route depth, separation metrics, and YAC analytics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=3

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "rt" "tgt" "rec" "yds" "td" "int" "rating" "catch" "xCatch" "croe" "ydsRec" "ydsRt" "epa" "epaTgt" "epaRt" "drop" "yac" "xYac" "yacoe" "yacRec" "avgSep" "ay" "ayTgt" "tgtRt" "avgRtDep" "ezTgt" "ezRec" "deepTgtPct" "twPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedReceiver
boolean
Default: false
Example: qualifiedReceiver=false

Filter to only qualified receivers (minimum target threshold)

teamOffense
Array of strings
Example: teamOffense=3000&teamOffense=3900

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedReceiver
boolean

Whether results are filtered to qualified receivers only

required
Array of objects (PlayerReceivingStats)
season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
string

Week identifier

Response samples

Content type
application/json
{
  • "limit": 50,
  • "offset": 0,
  • "qualifiedReceiver": false,
  • "receivers": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3900",
  • "total": 12,
  • "week": "WEEK_3"
}

Get Player Receiving Statistics by Week

Retrieves comprehensive receiving statistics for NFL players during a specified week and season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified receivers, and various sorting options. Data includes catch percentage, yards per reception, EPA (Expected Points Added), CROE (Catch Rate Over Expected), target share, route depth, separation metrics, and YAC analytics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
string
Enum: "WEEK_1" "WEEK_2" "WEEK_3" "WEEK_4" "WEEK_5" "WEEK_6" "WEEK_7" "WEEK_8" "WEEK_9" "WEEK_10" "WEEK_11" "WEEK_12" "WEEK_13" "WEEK_14" "WEEK_15" "WEEK_16" "WEEK_17" "WEEK_18"
Example: week=WEEK_3

Week identifier

limit
integer [ 1 .. 100 ]
Default: 50
Example: limit=50

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "rt" "tgt" "rec" "yds" "td" "int" "rating" "catch" "xCatch" "croe" "ydsRec" "ydsRt" "epa" "epaTgt" "epaRt" "drop" "yac" "xYac" "yacoe" "yacRec" "avgSep" "ay" "ayTgt" "tgtRt" "avgRtDep" "ezTgt" "ezRec" "deepTgtPct" "twPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedReceiver
boolean
Default: false
Example: qualifiedReceiver=false

Filter to only qualified receivers (minimum target threshold)

teamOffense
Array of strings
Example: teamOffense=3900&teamOffense=3200

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedReceiver
boolean

Whether results are filtered to qualified receivers only

required
Array of objects (PlayerReceivingStats)
season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
string

Week identifier

Response samples

Content type
application/json
{
  • "limit": 50,
  • "offset": 0,
  • "qualifiedReceiver": false,
  • "receivers": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3900",
  • "total": 12,
  • "week": "WEEK_3"
}

Get Player Rushing Statistics by Season

Retrieves comprehensive rushing statistics for NFL players during a specified season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified rushers, and various sorting options. Data includes yards per carry, EPA (Expected Points Added), RYOE (Rush Yards Over Expected), efficiency metrics, yards before/after contact, and situational breakdowns.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=3

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "att" "yds" "td" "ypc" "epa" "epaAtt" "xRy" "xYpc" "ryoe" "ryoeAtt" "yaco" "yacoAtt" "ybco" "success" "fum" "lost" "rush10PYds" "rush15PMph" "rush20PMph" "eff" "inTPct" "stBoxPct" "underPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedRusher
boolean
Default: false
Example: qualifiedRusher=false

Filter to only qualified rushers (minimum attempts threshold)

teamOffense
Array of strings
Example: teamOffense=3000&teamOffense=3900

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedRusher
boolean

Whether results are filtered to qualified rushers only

required
Array of objects (PlayerRushingStats)
season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

Response samples

Content type
application/json
{
  • "limit": 3,
  • "offset": 0,
  • "qualifiedRusher": false,
  • "rushers": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3000",
  • "total": 7
}

Get Player Rushing Statistics by Week

Retrieves comprehensive rushing statistics for NFL players during a specified week and season. Returns detailed metrics including traditional stats, advanced analytics, and Next Gen Stats data. Supports filtering by teams, qualified rushers, and various sorting options. Data includes yards per carry, EPA (Expected Points Added), RYOE (Rush Yards Over Expected), efficiency metrics, yards before/after contact, and game-specific context.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
string
Enum: "WEEK_1" "WEEK_2" "WEEK_3" "WEEK_4" "WEEK_5" "WEEK_6" "WEEK_7" "WEEK_8" "WEEK_9" "WEEK_10" "WEEK_11" "WEEK_12" "WEEK_13" "WEEK_14" "WEEK_15" "WEEK_16" "WEEK_17" "WEEK_18"
Example: week=WEEK_3

Week identifier

limit
integer [ 1 .. 100 ]
Default: 50
Example: limit=50

Maximum number of players to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "yds"
Enum: "att" "yds" "td" "ypc" "epa" "epaAtt" "xRy" "xYpc" "ryoe" "ryoeAtt" "yaco" "yacoAtt" "ybco" "success" "fum" "lost" "rush10PYds" "rush15PMph" "rush20PMph" "eff" "inTPct" "stBoxPct" "underPct"
Example: sortKey=yds

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

qualifiedRusher
boolean
Default: false
Example: qualifiedRusher=false

Filter to only qualified rushers (minimum attempts threshold)

teamOffense
Array of strings
Example: teamOffense=3900&teamOffense=3200

Filter by specific team IDs (supports multiple teams)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

qualifiedRusher
boolean

Whether results are filtered to qualified rushers only

required
Array of objects (WeeklyPlayerRushingStats)
season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamOffense
string

Team filter applied (if any)

total
required
integer

Total number of players matching the criteria

week
required
string

Week identifier

Response samples

Content type
application/json
{
  • "limit": 50,
  • "offset": 0,
  • "qualifiedRusher": false,
  • "rushers": [
    ],
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "yds",
  • "sortValue": "DESC",
  • "teamOffense": "3200",
  • "total": 4,
  • "week": "WEEK_3"
}

Get Team Defense Statistics by Season

Retrieves comprehensive defensive statistics for NFL teams during a specified season. Returns detailed metrics including traditional defensive stats, advanced analytics like EPA and RYOE, Next Gen Stats data, and situational performance breakdowns. Supports filtering by various defensive situations including personnel packages (Base, Nickel, Dime), game situations (leading, trailing, tied), field positions (red zone, goal-to-go), and offensive formations faced (shotgun, under center, pistol, motion).

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "ypg"
Enum: "total" "pass" "run" "yds" "passPct" "ypp" "td" "passTd" "rushTd" "epa" "epaPP" "passYds" "passYpp" "epaPass" "epaPassPP" "rushYds" "rushYpp" "epaRush" "epaRushPP" "ttt" "qbp" "qbpPct" "sackedYds" "ryoe" "interception" "forcedFumble" "fumbleRecovered" "defensiveTouchdown" "totalTakeaways" "ppg" "ypg" "passYpg" "rushYpg" "sackedYpg"
Example: sortKey=ypg

Field to sort by

sortValue
string
Default: "ASC"
Enum: "ASC" "DESC"
Example: sortValue=ASC

Sort direction

split
Array of strings
Items Enum: "TEAM_DEFENSE_BASE" "TEAM_DEFENSE_NICKEL" "TEAM_DEFENSE_DIME" "TEAM_DEFENSE_WHEN_LEADING" "TEAM_DEFENSE_WHEN_TRAILING" "TEAM_DEFENSE_WHEN_TIED" "TEAM_DEFENSE_RED_ZONE" "TEAM_DEFENSE_GOAL_TO_GO" "TEAM_DEFENSE_SHOTGUN" "TEAM_DEFENSE_UNDER_CENTER" "TEAM_DEFENSE_PISTOL" "TEAM_DEFENSE_MOTION"
Example: split=TEAM_DEFENSE_NICKEL&split=TEAM_DEFENSE_RED_ZONE

Defensive situation splits to filter by (supports multiple values)

Responses

Response Schema: application/json
required
Array of objects (TeamDefenseStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

split
Array of strings

Applied defensive situation splits

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "defense": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "ypg",
  • "sortValue": "ASC",
  • "split": [
    ],
  • "total": 32
}

Get Team Defense Pass Statistics by Season

Retrieves comprehensive pass defense statistics for NFL teams during a specified season. Returns detailed metrics including traditional defensive stats, advanced analytics like EPA and YACOE (Yards After Catch Over Expected), Next Gen Stats data, and situational performance breakdowns. Supports various sorting options and includes pressure rates, coverage metrics, quarterback disruption stats, and receiver separation allowed.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "passYpg"
Enum: "total" "pass" "passPct" "passTd" "passYds" "passYpp" "epaPass" "epaPassPP" "ttt" "qbp" "qbpPct" "sackedYds" "sack" "sackPct" "ttp" "blitzPct" "yac" "yacoe" "sep" "go" "passYpg" "sackedYpg"
Example: sortKey=passYpg

Field to sort by

sortValue
string
Default: "ASC"
Enum: "ASC" "DESC"
Example: sortValue=ASC

Sort direction

Responses

Response Schema: application/json
required
Array of objects (TeamDefensePassStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "defense": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "passYpg",
  • "sortValue": "ASC",
  • "total": 32
}

Get Team Defense Rush Statistics by Season

Retrieves comprehensive rush defense statistics for NFL teams during a specified season. Returns detailed metrics including traditional run defense stats, advanced analytics like EPA and RYOE (Rush Yards Over Expected), Next Gen Stats data, and situational performance breakdowns. Supports various sorting options and includes stuff rates, gap analysis, box count distributions, and directional rush defense metrics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "rushYpg"
Enum: "total" "run" "runPct" "rushTd" "rushYds" "rushYpp" "epaRush" "epaRushPP" "rush10PYds" "stuffPct" "ryoe" "ryoeAtt" "ybcoAtt" "yacoAtt" "inPct" "outPct" "lightPct" "stackedPct" "rushYpg"
Example: sortKey=rushYpg

Field to sort by

sortValue
string
Default: "ASC"
Enum: "ASC" "DESC"
Example: sortValue=ASC

Sort direction

Responses

Response Schema: application/json
required
Array of objects (TeamDefenseRushStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "defense": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "rushYpg",
  • "sortValue": "ASC",
  • "total": 32
}

Get Team Offense Overview Statistics by Season

Retrieves comprehensive offensive overview statistics for NFL teams during a specified season. Returns detailed metrics including traditional offensive stats, advanced analytics like EPA and efficiency ratings, Next Gen Stats data, and situational performance breakdowns. Supports filtering by various offensive situations including formations (shotgun, under center, pistol), game situations (leading, trailing, tied), and field positions (red zone, goal-to-go). Includes total offense, passing offense, rushing offense, and scoring metrics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "ypg"
Enum: "total" "pass" "run" "yds" "passPct" "ypp" "td" "passTd" "rushTd" "epa" "epaPP" "passYds" "passYpp" "epaPass" "epaPassPP" "rushYds" "rushYpp" "epaRush" "epaRushPP" "to" "ppg" "ypg" "passYpg" "rushYpg" "redZonePct" "thirdDownPct"
Example: sortKey=ypg

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

teamDefense
string
Example: teamDefense=2250

Filter by specific team identifier

split
Array of strings
Items Enum: "TEAM_SHOTGUN" "TEAM_UNDER_CENTER" "TEAM_PISTOL" "TEAM_WHEN_LEADING" "TEAM_WHEN_TRAILING" "TEAM_WHEN_TIED" "TEAM_RED_ZONE" "TEAM_GOAL_TO_GO"
Example: split=TEAM_WHEN_LEADING

Offensive situation splits to filter by (supports multiple values)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

required
Array of objects (TeamOffenseOverviewStats)
offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

split
Array of strings

Applied offensive situation splits

teamDefense
string

Team filter applied (if any)

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "limit": 35,
  • "offense": [
    ],
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "ypg",
  • "sortValue": "DESC",
  • "split": [
    ],
  • "teamDefense": "2250",
  • "total": 0
}

Get Team Offense Pass Statistics by Season

Retrieves comprehensive pass offense statistics for NFL teams during a specified season. Returns detailed metrics including traditional offensive stats, advanced analytics like EPA and YACOE (Yards After Catch Over Expected), Next Gen Stats data, and situational performance breakdowns. Supports various sorting options and includes pressure rates, quarterback metrics, completion rates, and receiver separation data.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "passYpg"
Enum: "total" "pass" "passPct" "passTd" "passYds" "passYpp" "epaPass" "epaPassPP" "ttt" "qbp" "qbpPct" "att" "sackedYds" "sack" "sackPct" "ttp" "blitzPct" "paPct" "yac" "yacoe" "sep" "passYpg" "sackedYpg"
Example: sortKey=passYpg

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

teamDefense
string
Example: teamDefense=2250

Filter by specific team ID

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

required
Array of objects (TeamOffensePassStats)
offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamDefense
string

Applied team filter (if any)

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "limit": 35,
  • "offense": [
    ],
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "passYpg",
  • "sortValue": "DESC",
  • "teamDefense": "2250",
  • "total": 3
}

Get Coaches Film Videos

Retrieves premium coaches film video content for specified games and plays. Returns multiple camera angles (endzone, sideline, broadcast) for each play, providing comprehensive film study material. Requires NFL Plus Premium subscription and appropriate geographic restrictions apply (US only).

Authorizations:
BearerAuth
query Parameters
gameId
required
Array of strings <uuid> [ 1 .. 10 ] items [ items <uuid > ]
Example: gameId=f665fc10-311e-11f0-b670-ae1250fadad1&gameId=ae9d66f7-1312-11ef-afd1-646009f18b2e

Game identifiers (UUID format, supports multiple games)

playId
required
Array of strings [ 1 .. 50 ] items
Example: playId=267&playId=1162&playId=496&playId=139

Play identifiers for specific plays within the games

Responses

Response Schema: application/json
required
Array of objects (CoachesFilmVideo)
required
object (ResponseMetadata)
object (Pagination)

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "metadata": {
    },
  • "pagination": {
    }
}

Get Filmroom Plays with Advanced Filtering

Retrieves detailed play-by-play data with extensive filtering capabilities for film study. Returns comprehensive play information including formations, personnel packages, game situations, and detailed play descriptions. This endpoint supports advanced filtering by game situation, player involvement, formation types, and tactical elements.

Authorizations:
BearerAuth
query Parameters
gameId
Array of strings <uuid> [ items <uuid > ]
Example: gameId=f665fc10-311e-11f0-b670-ae1250fadad1

Filter by specific game IDs (supports multiple values)

weekSlug
Array of strings
Items Enum: "WEEK_1" "WEEK_2" "WEEK_3" "WEEK_4" "WEEK_5" "WEEK_6" "WEEK_7" "WEEK_8" "WEEK_9" "WEEK_10" "WEEK_11" "WEEK_12" "WEEK_13" "WEEK_14" "WEEK_15" "WEEK_16" "WEEK_17" "WEEK_18"
Example: weekSlug=WEEK_3

Filter by week identifier (supports multiple values)

season
Array of integers
Example: season=2025

Filter by season year (supports multiple values)

seasonType
Array of strings
Items Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Filter by season type

nflId
Array of strings
Example: nflId=54517

Filter by player NFL ID

quarter
Array of integers[ items [ 1 .. 4 ] ]
Example: quarter=1

Filter by quarter

down
Array of integers[ items [ 1 .. 4 ] ]
Example: down=1

Filter by down

yardsToGoType
Array of strings
Items Enum: "SHORT" "MID" "LONG"
Example: yardsToGoType=SHORT

Filter by yards to go category

touchdown
Array of integers
Items Enum: 0 1
Example: touchdown=1

Filter for touchdown plays (1 = yes, 0 = no)

rush10PlusYards
Array of integers
Items Enum: 0 1
Example: rush10PlusYards=1

Filter for rushing plays of 10+ yards

fumbleLost
Array of integers
Items Enum: 0 1
Example: fumbleLost=1

Filter for plays with fumbles lost

fumble
Array of integers
Items Enum: 0 1
Example: fumble=1

Filter for plays with fumbles

qbAlignment
Array of strings
Items Enum: "PISTOL" "UNDER_CENTER" "SHOTGUN"
Example: qbAlignment=SHOTGUN

Filter by quarterback alignment

redzone
Array of integers
Items Enum: 0 1
Example: redzone=1

Filter for red zone plays

goalToGo
Array of integers
Items Enum: 0 1
Example: goalToGo=1

Filter for goal-to-go situations

passPlay
Array of integers
Items Enum: 0 1
Example: passPlay=1

Filter for passing plays

runPlay
Array of integers
Items Enum: 0 1
Example: runPlay=1

Filter for running plays

playType
Array of strings
Items Enum: "play_type_kickoff" "play_type_field_goal" "play_type_rush" "play_type_sack" "play_type_two_point_conversion" "play_type_xp" "play_type_pass" "play_type_punt" "play_type_unknown"
Example: playType=play_type_rush

Filter by specific play types

attempt
Array of integers
Items Enum: 0 1
Example: attempt=1

Filter for passing attempts

completion
Array of integers
Items Enum: 0 1
Example: completion=1

Filter for completed passes

interception
Array of integers
Items Enum: 0 1
Example: interception=1

Filter for interceptions

reception
Array of integers
Items Enum: 0 1
Example: reception=1

Filter for receptions

sack
Array of integers
Items Enum: 0 1
Example: sack=1

Filter for sacks

rec_motion
Array of integers
Items Enum: 0 1
Example: rec_motion=1

Filter by receiver motion

targetLocation
Array of strings
Items Enum: "DOWN_SEAMS" "BETWEEN_HASHES" "OUTSIDE_NUMBERS"
Example: targetLocation=BETWEEN_HASHES

Filter by target location on field

airYardType
Array of strings
Items Enum: "INTERMEDIATE" "SHORT" "DEEP"
Example: airYardType=SHORT

Filter by air yards category

dropbackTimeType
Array of strings
Items Enum: "QUICK" "LONG"
Example: dropbackTimeType=QUICK

Filter by dropback time

pressure
Array of integers
Items Enum: 0 1
Example: pressure=1

Filter by quarterback pressure

blitz
Array of integers
Items Enum: 0 1
Example: blitz=1

Filter by defensive blitz

playAction
Array of integers
Items Enum: 0 1
Example: playAction=1

Filter by play action usage

rushDirection
Array of strings
Items Enum: "INSIDE" "OUTSIDE"
Example: rushDirection=INSIDE

Filter by rush direction

runStuff
Array of integers
Items Enum: 0 1
Example: runStuff=1

Filter for stuffed runs

receiverAlignment
Array of strings
Items Enum: "SLOT" "BACKFIELD" "TIGHT" "WIDE"
Example: receiverAlignment=SLOT

Filter by receiver alignment

separationType
Array of strings
Items Enum: "OPEN" "TIGHT"
Example: separationType=OPEN

Filter by receiver separation

personnel
Array of strings
Items Enum: "NICKEL" "BASE" "DIME"
Example: personnel=NICKEL

Filter by defensive personnel package

defendersInTheBoxType
Array of strings
Items Enum: "LIGHT" "STACKED" "NEUTRAL"
Example: defendersInTheBoxType=STACKED

Filter by defenders in the box

def_coverageType
Array of strings
Items Enum: "PRESS" "MAN" "ZONE"
Example: def_coverageType=PRESS

Filter by defensive coverage type

Responses

Response Schema: application/json
count
required
integer

Total number of plays matching the filter criteria

required
Array of objects (FilmroomPlay)

Array of play data matching the filter criteria

Response samples

Content type
application/json
{
  • "count": 148,
  • "plays": [
    ]
}

Get Game Boxscore

Retrieves comprehensive boxscore data for a specific game including team statistics, individual player statistics, and scoring summary. Returns empty arrays for future games.

Authorizations:
BearerAuth
query Parameters
gameId
required
string^\d{10}$
Example: gameId=2025092800

Game identifier (10-digit format YYYYMMDDNN)

Responses

Response Schema: application/json
object (TeamBoxscore)
gameId
string

Game identifier

object (TeamBoxscore)
object (BoxscoreSchedule)

Response samples

Content type
application/json
{
  • "away": {
    },
  • "gameId": "2025092800",
  • "home": {
    },
  • "schedule": {
    }
}

Get Team Rankings for Game

Retrieves comprehensive statistical rankings for both teams in a specific game. Returns 300+ statistical categories with rankings for offensive, defensive, and special teams performance.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

awayTeamId
required
string <uuid>
Example: awayTeamId=10403000-5851-f9d5-da45-78365a05b6b0

Away team UUID

homeTeamId
required
string <uuid>
Example: homeTeamId=10403900-8251-6892-d81c-4348525c2d47

Home team UUID

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number

Responses

Response Schema: application/json
object (TeamRankings)
object (TeamRankings)

Response samples

Content type
application/json
{
  • "awayRankings": {
    },
  • "homeRankings": {
    }
}

Get Gamecenter Statistics

Retrieves advanced game statistics including passer zones, receiver separation, pass rush metrics, and performance leaders for a specific game.

Authorizations:
BearerAuth
query Parameters
gameId
required
string
Example: gameId=2025092800

Game identifier

Responses

Response Schema: application/json
object
object
object
object
object
object (GamecenterSchedule)

Response samples

Content type
application/json
{
  • "leaders": {
    },
  • "passRushers": {
    },
  • "passers": {
    },
  • "receivers": {
    },
  • "rushers": {
    },
  • "schedule": {
    }
}

Get Multiple Rankings for All Teams

Retrieves rankings for all 32 NFL teams across multiple specified statistical categories. Allows comparison of teams across up to 5 different statistics simultaneously.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

stat0
required
string
Example: stat0=scoring-averagePointsScored

First statistical category

stat1
string
Example: stat1=offense-yardsPerGame

Second statistical category

stat2
string
Example: stat2=offense-rushYardsPerGame

Third statistical category

stat3
string
Example: stat3=offense-passYardsPerGame

Fourth statistical category

stat4
string
Example: stat4=misc-netTurnovers

Fifth statistical category

Responses

Response Schema: application/json
Array
object
statCategory
string

Category of statistic

statName
string

Name of specific statistic

Array of objects (TeamRankingEntry)

Response samples

Content type
application/json
[
  • {
    }
]

Get All Teams

Retrieves information for all NFL teams including regular teams and Pro Bowl teams. Returns comprehensive team data including colors, logos, stadiums, and contact information.

Authorizations:
BearerAuth

Responses

Response Schema: application/json
Array
abbr
string

Three-letter team abbreviation

altColor
string

Alternate team color in hex format

city
string

Team city/location

cityState
string

Team city and state

object (Conference)
conferenceAbbr
string
Enum: "AFC" "NFC"

Conference abbreviation

darkColor
string

Dark team color in hex format

object (Division)
domain
string

Team website domain prefix

fullName
string

Full team name

isProBowl
boolean
Default: false

Whether this is a Pro Bowl team

logo
string <uri>

URL to team logo (may contain formatInstructions placeholder)

name
string

Team name

nick
string

Team nickname (short form)

nickname
string

Team nickname

primaryColor
string

Primary team color in hex format

season
integer

Current season year

secondaryColor
string

Secondary team color in hex format

slug
string

URL-friendly team identifier

smartId
string <uuid>

Unique smart identifier for the team

stadiumName
string

Name of the team's home stadium

teamId
string

Team identifier (4-digit string)

teamSiteTicketUrl
string or null <uri>

URL to team's ticket purchase page

teamSiteUrl
string or null <uri>

Team's official website URL

teamType
string
Enum: "TEAM" "PRO"

Type of team (regular or Pro Bowl)

tertiaryColor
string

Tertiary team color in hex format

ticketPhoneNumber
string or null

Phone number for ticket purchases

yearFound
integer

Year the team was founded

Response samples

Content type
application/json
[
  • {
    }
]

Get Team Roster

Retrieves the complete roster for a specific team and season. Returns detailed player information including physical attributes, college info, and experience.

Authorizations:
BearerAuth
query Parameters
teamId
required
string
Example: teamId=3000

Team identifier (4-digit string)

season
required
integer
Example: season=2025

Season year

Responses

Response Schema: application/json
season
integer

Season year

object (TeamInfo)

Basic team information included in roster responses

Array of objects (Player)

Response samples

Content type
application/json
{
  • "season": 2025,
  • "team": {
    },
  • "teamPlayers": [
    ]
}

Get Weekly Team Roster

Retrieves the roster for a specific team, season, season type, and week. Returns player information with weekly status and availability.

Authorizations:
BearerAuth
query Parameters
teamId
required
string
Example: teamId=3900

Team identifier (4-digit string)

season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=3

Week number within the season

Responses

Response Schema: application/json
season
integer

Season year

seasonType
string
Enum: "PRE" "REG" "POST"

Type of season

object (TeamInfo)

Basic team information included in roster responses

Array of objects (WeeklyPlayer)
week
integer

Week number

Response samples

Content type
application/json
{
  • "season": 2025,
  • "seasonType": "PRE",
  • "team": {
    },
  • "teamPlayers": [
    ],
  • "week": 3
}

Get Team Schedule

Retrieves the complete schedule for a specific team and season. Returns all games including preseason, regular season, and postseason with scores for completed games.

Authorizations:
BearerAuth
query Parameters
teamId
required
string
Example: teamId=3000

Team identifier (4-digit string)

season
required
integer
Example: season=2025

Season year

Responses

Response Schema: application/json
Array
gameDate
string or null <date>

Game date (YYYY-MM-DD format)

gameId
integer

Game identifier (format is YYYYMMDDNN)

gameKey
integer

Unique game key

gameTime
string or null <date-time>

Game time in UTC

gameTimeEastern
string or null

Game time in Eastern timezone (HH:MM:SS)

gameType
string
Enum: "PRE" "REG" "POST"

Type of game

homeDisplayName
string

Home team display name

homeNickname
string

Home team nickname

object (ScheduleTeam)
homeTeamAbbr
string

Home team abbreviation

homeTeamId
string

Home team identifier

isoTime
integer or null

Unix timestamp in milliseconds

networkChannel
string or null

Broadcast network

ngsGame
boolean

Whether Next Gen Stats are available

releasedToClubs
boolean

Whether game info is released to clubs

object (GameScore)
season
integer

Season year

seasonType
string
Enum: "PRE" "REG" "POST"
object (GameSite)
smartId
string <uuid>

Smart identifier for the game

validated
boolean

Whether game info is validated

visitorDisplayName
string

Visitor team display name

visitorNickname
string

Visitor team nickname

object (ScheduleTeam)
visitorTeamAbbr
string

Visitor team abbreviation

visitorTeamId
string

Visitor team identifier

week
integer

Week number

weekNameAbbr
string

Week name abbreviation

Response samples

Content type
application/json
[
  • {
    }
]

Regular API

Endpoints provided as part of the Regular (non-paywalled) NFL API

Get Games by Season and Week

Retrieves game information for a specific season, season type, and week. Returns comprehensive game data including teams, venues, broadcast information, and ticket details.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year (e.g., 2025)

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

Responses

Response Schema: application/json
Array of objects (ProGame)
object (Pagination)

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "pagination": {
    }
}

Get All Teams

Retrieves information for all NFL teams including Pro Bowl teams. Returns comprehensive team data including logos, colors, venues, and social media links.

Authorizations:
BearerAuth
query Parameters
allteams
boolean
Example: allteams=true

Include all teams including special teams

season
required
integer
Example: season=2025

Season year

Responses

Response Schema: application/json
Array of objects (Team)

Response samples

Content type
application/json
{
  • "teams": [
    ]
}

Get Draft Information

Retrieves draft information for a specific year including all rounds, picks, traded picks, and compensatory selections.

Authorizations:
BearerAuth
path Parameters
year
required
integer
Example: 2025

Draft year

query Parameters
round
integer [ 1 .. 7 ]

Filter by round

teamId
string <uuid>

Filter by team

Responses

Response Schema: application/json
Array of objects
year
integer

Response samples

Content type
application/json
{
  • "rounds": [
    ],
  • "year": 0
}

Get Weekly Game Details with Standings

Retrieves detailed game information for a specific week including team standings, drive charts, replays, and tagged videos.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

type
required
string
Enum: "PRE" "REG" "POST"
Example: type=REG

Season type

week
required
integer
Example: week=4

Week number

includeDriveChart
boolean
Default: false

Include drive chart data

includeReplays
boolean
Default: false

Include replay videos

includeStandings
boolean
Default: false

Include team standings

includeTaggedVideos
boolean
Default: false

Include tagged video content

Responses

Response Schema: application/json
Array
object (Team)
object (BroadcastInfo)
category
string or null
Enum: "TNF" "SNF" "MNF"

Prime time game designation

date
string <date>

Game date (YYYY-MM-DD)

dateAmPm
string
Enum: "AM" "PM"
dateDay
string

Day of week (full)

dateDayMonth
string

Date in M/D format

dateDayShort
string

Day of week (abbreviated)

dateTime
string

Time without AM/PM

dateTimeAmPm
string

Time with AM/PM

extensions
Array of objects

Additional game data extensions

Array of objects (ExternalId)
gameType
string

Type of game

object (Team)
id
string <uuid>

Unique game identifier

international
boolean

Whether game is played internationally

neutralSite
boolean

Whether game is at neutral venue

phase
string

Game phase

season
integer

Season year

seasonType
string
Enum: "PRE" "REG" "POST"

Season type

status
string
Enum: "SCHEDULED" "IN_PROGRESS" "FINAL" "POSTPONED" "CANCELLED"

Game status

ticketUrl
string or null <uri>

Primary ticket purchase URL

Array of objects (TicketVendor)
time
string <date-time>

Game time in UTC

object (Venue)
version
integer

Data version number

week
integer

Week number

weekType
string

Week type (e.g., REG, HOF)

object (Standings)
driveChart
object or null

Drive-by-drive data

object (Standings)
replays
Array of objects

Replay video links

summary
object or null

Game summary information

taggedVideos
object or null

Tagged video content

Response samples

Content type
application/json
[
  • {
    }
]

Get Games by Season, Type, and Week

Retrieves game information for a specific season, season type, and week from the Football API. This endpoint provides core game data with external IDs.

Authorizations:
BearerAuth
path Parameters
season
required
integer
Example: 2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: REG

Type of season

week
required
integer
Example: 4

Week number

query Parameters
withExternalIds
boolean
Default: false

Include external IDs in response

Responses

Response Schema: application/json
Array of objects (ProGame)
object (Pagination)

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "pagination": {
    }
}

Get Game Box Score

Retrieves comprehensive box score data for a specific game including team statistics, individual player statistics, and scoring summary.

Authorizations:
BearerAuth
path Parameters
gameId
required
string <uuid>

Game identifier (UUID)

Responses

Response Schema: application/json
object (ProGame)
object
Array of objects (ScoringPlay)
object

Response samples

Content type
application/json
{
  • "game": {
    },
  • "playerStats": {
    },
  • "scoringSummary": [
    ],
  • "teamStats": {
    }
}

Get Play-by-Play Data

Retrieves detailed play-by-play data for a specific game including all plays, drives, scoring events, and key statistics.

Authorizations:
BearerAuth
path Parameters
gameId
required
string <uuid>

Game identifier (UUID)

query Parameters
includePenalties
boolean
Default: true

Include penalty details

includeFormations
boolean
Default: false

Include offensive/defensive formations

Responses

Response Schema: application/json
object (Drive)
Array of objects (Drive)
object (ProGame)
object (Play)
Array of objects (ScoringPlay)

Response samples

Content type
application/json
{
  • "currentDrive": {
    },
  • "drives": [
    ],
  • "game": {
    },
  • "lastPlay": {
    },
  • "scoringSummary": [
    ]
}

Get Injury Reports

Retrieves current injury reports for all teams or specific teams with injury status, designation, and practice participation.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

week
required
integer
Example: week=4

Week number

teamId
string <uuid>

Filter by specific team

Responses

Response Schema: application/json
Array of objects (TeamInjuryReport)
season
integer
week
integer

Response samples

Content type
application/json
{
  • "reports": [
    ],
  • "season": 0,
  • "week": 0
}

Get Team Roster

Retrieves the complete roster for a specific team including active, practice squad, and injured reserve players with detailed player information.

Authorizations:
BearerAuth
path Parameters
teamId
required
string <uuid>
Example: 10403800-517c-7b8c-65a3-c61b95d86123

Team identifier (UUID)

query Parameters
season
required
integer
Example: season=2025

Season year

includeStats
boolean
Default: false

Include current season statistics

Responses

Response Schema: application/json
object
season
integer
object (Team)

Response samples

Content type
application/json
{
  • "roster": {
    },
  • "season": 0,
  • "team": {
    }
}

Get Player Details

Retrieves detailed information about a specific player including biography, career statistics, and current season performance.

Authorizations:
BearerAuth
path Parameters
playerId
required
string
Example: 2560726

Player identifier

query Parameters
season
integer
Example: season=2025

Season for statistics (defaults to current)

Responses

Response Schema: application/json
birthDate
string <date>

Player's birth date

collegeConference
string

Player's college conference

collegeName
string

Player's college

currentTeamId
string

Current team identifier

displayName
string

Player's display name

draftClub
string or null

Team that drafted the player

draftNumber
integer or null

Overall draft pick number

draftround
integer or null

Draft round

entryYear
integer

Year player entered the league

esbId
string

ESB identifier

firstName
string

Player's first name

footballName
string

Player's football name (nickname)

gsisId
string

GSIS identifier

gsisItId
integer

GSIS IT identifier

headshot
string <uri>

URL to player headshot image

height
string

Player height (format is feet-inches)

jerseyNumber
integer

Player's jersey number

lastName
string

Player's last name

nflId
integer

NFL player identifier

ngsPosition
string or null

Next Gen Stats position

ngsPositionGroup
string or null

Next Gen Stats position group

position
string

Player's position

positionGroup
string

Player's position group

rookieYear
integer

Player's rookie year

season
integer

Current season

shortName
string

Shortened player name

smartId
string <uuid>

Smart identifier for the player

status
string

Player status code

statusDescriptionAbbr
string

Abbreviated status description

statusShortDescription
string

Short status description

teamAbbr
string

Current team abbreviation

uniformNumber
string

Player's uniform number (formatted)

weight
integer

Player weight in pounds

yearsOfExperience
integer

Years of NFL experience

Array of objects (Award)
biography
string

Player biography

object (CareerStats)
object (ContractInfo)
object (SeasonStats)

Response samples

Content type
application/json
{
  • "birthDate": "2019-08-24",
  • "collegeConference": "Southeastern Conference",
  • "collegeName": "Louisiana State",
  • "currentTeamId": "string",
  • "displayName": "Justin Jefferson",
  • "draftClub": "string",
  • "draftNumber": 0,
  • "draftround": 0,
  • "entryYear": 0,
  • "esbId": "string",
  • "firstName": "string",
  • "footballName": "string",
  • "gsisId": "string",
  • "gsisItId": 0,
  • "headshot": "http://example.com",
  • "height": "6-3",
  • "jerseyNumber": 0,
  • "lastName": "string",
  • "nflId": 52430,
  • "ngsPosition": "string",
  • "ngsPositionGroup": "string",
  • "position": "WR",
  • "positionGroup": "WR",
  • "rookieYear": 0,
  • "season": 0,
  • "shortName": "J.Jefferson",
  • "smartId": "884e3ef1-4039-4f0d-913c-7988cf03848f",
  • "status": "ACT",
  • "statusDescriptionAbbr": "A01",
  • "statusShortDescription": "Active",
  • "teamAbbr": "string",
  • "uniformNumber": "18",
  • "weight": 0,
  • "yearsOfExperience": 0,
  • "awards": [
    ],
  • "biography": "string",
  • "careerStats": {
    },
  • "contractInfo": {
    },
  • "currentSeasonStats": {
    }
}

Get Standings

Retrieves team standings for a specific season, season type, and week. Includes division, conference, and overall standings with detailed statistics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer
Example: week=3

Week number

limit
integer [ 1 .. 100 ]
Default: 20

Maximum number of results to return

Responses

Response Schema: application/json
object (Pagination)
season
integer
seasonType
string
Enum: "PRE" "REG" "POST"
week
integer

Current week for standings

Array of objects

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "season": 0,
  • "seasonType": "PRE",
  • "week": 0,
  • "weeks": [
    ]
}

Get Live Game Statistics

Retrieves live game statistics and summaries for games in progress or completed games. Provides real-time statistical data for specified season, type, and week.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer
Example: week=4

Week number

Responses

Response Schema: application/json
data
Array of objects
object (Pagination)

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "pagination": {
    }
}

Get Season Player Statistics

Retrieves aggregated player statistics for a specific season with filtering options by position, team, and statistical categories.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

position
string
Enum: "QB" "RB" "WR" "TE" "OL" "DL" "LB" "DB" "K" "P" "LS"

Filter by position group

teamId
string <uuid>

Filter by team

statCategory
string
Enum: "passing" "rushing" "receiving" "defense" "kicking" "punting" "returning"
Example: statCategory=passing

Statistical category to retrieve

sort
string
Example: sort=passingYards:desc

Sort field and order

limit
integer [ 1 .. 500 ]
Default: 50

Maximum number of results

offset
integer >= 0
Default: 0

Offset for pagination

Responses

Response Schema: application/json
object
Array of objects
season
integer
seasonType
string
statCategory
string

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "players": [
    ],
  • "season": 0,
  • "seasonType": "string",
  • "statCategory": "string"
}

Get Transactions

Retrieves recent transactions including trades, signings, releases, practice squad moves, and injured reserve designations.

Authorizations:
BearerAuth
query Parameters
startDate
string <date>
Example: startDate=2025-01-01

Start date for transactions (ISO 8601)

endDate
string <date>
Example: endDate=2025-09-24

End date for transactions (ISO 8601)

teamId
string <uuid>

Filter by team

transactionType
string
Enum: "TRADE" "SIGNED" "RELEASED" "WAIVED" "PRACTICE_SQUAD" "IR" "SUSPENDED"

Type of transaction

limit
integer [ 1 .. 100 ]
Default: 20

Maximum number of results

Responses

Response Schema: application/json
object (Pagination)
Array of objects (Transaction)

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "transactions": [
    ]
}

Get NFL Venues

Retrieves information about all NFL stadiums and venues, including international venues. Provides venue details such as addresses, locations, and territories.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

limit
integer [ 1 .. 100 ]
Default: 20

Maximum number of venues to return

Responses

Response Schema: application/json
object (Pagination)
Array of objects (Venue)

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "venues": [
    ]
}

Get Season Weeks

Retrieves all weeks for a specific season including preseason, regular season, and postseason. Includes bye team information for each week.

Authorizations:
BearerAuth
path Parameters
season
required
integer
Example: 2025

Season year

query Parameters
limit
integer [ 1 .. 100 ]
Default: 20

Maximum number of weeks to return

Responses

Response Schema: application/json
object (Pagination)
Array of objects (ProWeek)

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "weeks": [
    ]
}

Generate Initial Access Token

Creates a new access token and refresh token for a client device. This is the initial authentication endpoint that establishes a session for accessing NFL APIs. Requires client credentials and device information.

Authorizations:
BearerAuth
Request Body schema: application/json
required
clientKey
required
string

Client application identifier key

clientSecret
required
string

Client application secret for authentication

deviceId
required
string <uuid>

Unique device identifier (UUID format)

deviceInfo
required
string

Base64-encoded JSON containing device information such as: {"model":"desktop","version":"Chrome","osName":"Windows","osVersion":"10"}

networkType
required
string
Enum: "other" "wifi" "cellular" "ethernet"

Type of network connection

Responses

Response Schema: application/json
accessToken
required
string

JWT access token containing user permissions, subscription plans, location data, and roles. Include this token in the Authorization header as "Bearer {accessToken}" for authenticated requests.

expiresIn
required
integer <int64>

Unix timestamp when the access token expires

refreshToken
required
string <uuid>

New refresh token for future token refresh requests

Request samples

Content type
application/json
{
  • "clientKey": "4cFUW6DmwJpzT9L7LrG3qRAcABG5s04g",
  • "clientSecret": "CZuvCL49d9OwfGsR",
  • "deviceId": "3cfdef35-c7fe-4f2d-8630-1ec72f52b44d",
  • "deviceInfo": "eyJtb2RlbCI6ImRlc2t0b3AiLCJ2ZXJzaW9uIjoiQ2hyb21lIiwib3NOYW1lIjoiV2luZG93cyIsIm9zVmVyc2lvbiI6IjEwIn0=",
  • "networkType": "other"
}

Response samples

Content type
application/json
{
  • "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  • "expiresIn": 1758732647,
  • "refreshToken": "0f5452b5-7f40-4c8e-9801-cf7fd2830de3"
}

Refresh Access Token

Refreshes an existing access token using a valid refresh token. This endpoint extends the user's session by generating new access and refresh tokens. Requires the previous refresh token and signature verification.

Authorizations:
BearerAuth
Request Body schema: application/json
required
clientKey
required
string

Client application identifier key

clientSecret
required
string

Client application secret for authentication

deviceId
required
string <uuid>

Unique device identifier (UUID format)

deviceInfo
required
string

Base64-encoded JSON containing device information such as: {"model":"desktop","version":"Chrome","osName":"Windows","osVersion":"10"}

networkType
required
string
Enum: "other" "wifi" "cellular" "ethernet"

Type of network connection

refreshToken
required
string <uuid>

Valid refresh token from previous authentication

signatureTimestamp
required
string

Unix timestamp for signature verification

uid
required
string

User identifier hash

uidSignature
required
string

HMAC signature for request verification

Responses

Response Schema: application/json
accessToken
required
string

JWT access token containing user permissions, subscription plans, location data, and roles. Include this token in the Authorization header as "Bearer {accessToken}" for authenticated requests.

expiresIn
required
integer <int64>

Unix timestamp when the access token expires

refreshToken
required
string <uuid>

New refresh token for future token refresh requests

Request samples

Content type
application/json
{
  • "clientKey": "4cFUW6DmwJpzT9L7LrG3qRAcABG5s04g",
  • "clientSecret": "CZuvCL49d9OwfGsR",
  • "deviceId": "3cfdef35-c7fe-4f2d-8630-1ec72f52b44d",
  • "deviceInfo": "eyJtb2RlbCI6ImRlc2t0b3AiLCJ2ZXJzaW9uIjoiQ2hyb21lIiwib3NOYW1lIjoiV2luZG93cyIsIm9zVmVyc2lvbiI6IjEwIn0=",
  • "networkType": "other",
  • "refreshToken": "640b00c7-33d8-44f2-ab46-e3d1284a4061",
  • "signatureTimestamp": "1758729181",
  • "uid": "df990acd951e4bd6940c3babc4341584",
  • "uidSignature": "587bdNt6EKYhhX9ASFOELX+2lqE="
}

Response samples

Content type
application/json
{
  • "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  • "expiresIn": 1758732782,
  • "refreshToken": "a175ada6-a2e2-4689-8ea4-b9d6cfb0da13"
}

Schedules

Game schedules, matchup rankings, and injury reports

Get Single Game Details

Retrieves detailed information for a specific game by its ID. Returns comprehensive game data including teams, score, venue, broadcast information, and current game status.

Authorizations:
BearerAuth
query Parameters
gameId
required
string <uuid>
Example: gameId=f665fc10-311e-11f0-b670-ae1250fadad1

Game identifier (UUID format)

Responses

Response Schema: application/json
gameDate
string
gameId
integer
gameKey
integer
gameTime
string <date-time>
gameTimeEastern
string
gameType
string
Enum: "PRE" "REG" "POST"
homeDisplayName
string
homeNickname
string
object (TeamInfo)

Basic team information included in roster responses

homeTeamAbbr
string
homeTeamId
string
isoTime
integer

Unix timestamp in milliseconds

networkChannel
string
ngsGame
boolean
releasedToClubs
boolean
object (GameScore)
season
integer
seasonType
string
Enum: "PRE" "REG" "POST"
object (Site)
smartId
string <uuid>
validated
boolean
visitorDisplayName
string
visitorNickname
string
object (TeamInfo)

Basic team information included in roster responses

visitorTeamAbbr
string
visitorTeamId
string
week
integer
weekNameAbbr
string

Response samples

Content type
application/json
{
  • "gameDate": "09/21/2025",
  • "gameId": 0,
  • "gameKey": 0,
  • "gameTime": "2019-08-24T14:15:22Z",
  • "gameTimeEastern": "string",
  • "gameType": "PRE",
  • "homeDisplayName": "string",
  • "homeNickname": "string",
  • "homeTeam": {
    },
  • "homeTeamAbbr": "string",
  • "homeTeamId": "string",
  • "isoTime": 0,
  • "networkChannel": "string",
  • "ngsGame": true,
  • "releasedToClubs": true,
  • "score": {
    },
  • "season": 0,
  • "seasonType": "PRE",
  • "site": {
    },
  • "smartId": "884e3ef1-4039-4f0d-913c-7988cf03848f",
  • "validated": true,
  • "visitorDisplayName": "string",
  • "visitorNickname": "string",
  • "visitorTeam": {
    },
  • "visitorTeamAbbr": "string",
  • "visitorTeamId": "string",
  • "week": 0,
  • "weekNameAbbr": "string"
}

Get Game Matchup Rankings

Retrieves comprehensive matchup rankings and statistical comparisons for both teams in a specific game. Returns offensive, defensive, and special teams rankings with Z-scores and advantage ratings for various statistical categories.

Authorizations:
BearerAuth
query Parameters
gameId
required
string^\d{10}$
Example: gameId=2025092500

Game identifier (10-digit format YYYYMMDDNN)

Responses

Response Schema: application/json
gameId
integer
gameKey
integer
object (TeamMatchupRankings)

Comprehensive team rankings across multiple statistical categories

season
integer
seasonType
string
Enum: "PRE" "REG" "POST"
object (TeamMatchupRankings)

Comprehensive team rankings across multiple statistical categories

week
integer

Response samples

Content type
application/json
{
  • "gameId": 2025092500,
  • "gameKey": 0,
  • "homeTeamMatchupRankings": {
    },
  • "season": 0,
  • "seasonType": "PRE",
  • "visitorTeamMatchupRankings": {
    },
  • "week": 0
}

Get Team Injuries for Game Week

Retrieves injury report information for a specific team in a given week. Returns player injury status and details for the specified team and week.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

teamId
required
string <uuid>
Example: teamId=10403000-5851-f9d5-da45-78365a05b6b0

Team identifier (UUID format)

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

Responses

Response Schema: application/json
Array of objects (TeamInjuryReport)
season
integer
week
integer

Response samples

Content type
application/json
{
  • "reports": [
    ],
  • "season": 0,
  • "week": 0
}

Get Games by Week

Retrieves all games for a specific season, season type, and week. Returns comprehensive game data including teams, venues, broadcast information, and ticket details for all games in the specified week.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=3

Week number within the season

Responses

Response Schema: application/json
Array of objects (Game)
season
string

Season year

seasonType
string
Enum: "PRE" "REG" "POST"

Type of season

week
string

Week number

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "season": "2025",
  • "seasonType": "REG",
  • "week": "3"
}

Schedules Extended

Current games, standings, and betting futures

Get Current Week Games

Retrieves all games for the current week of the NFL season. Returns comprehensive game data including teams, venues, broadcast information, scores (for completed games), and ticket details. The endpoint automatically determines the current week based on the current date.

Authorizations:
BearerAuth

Responses

Response Schema: application/json
Array of objects (CurrentGame)
gamesPlayedSmartIds
Array of strings <uuid> [ items <uuid > ]

Smart IDs of games already played

numberOfGames
integer

Total number of games in the week

numberOfGamesPlayed
integer

Number of games already played

season
integer

Current season year

seasonType
string
Enum: "PRE" "REG" "POST"

Current season type

week
integer

Current week number

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "gamesPlayedSmartIds": [
    ],
  • "numberOfGames": 0,
  • "numberOfGamesPlayed": 0,
  • "season": 2025,
  • "seasonType": "PRE",
  • "week": 0
}

Get Future Betting Odds

Retrieves comprehensive betting futures data including Super Bowl odds, conference championship odds, and division winner odds for all teams. Returns decimal odds for each selection along with availability status. This endpoint provides futures market data across multiple betting hierarchies.

Authorizations:
BearerAuth

Responses

Response Schema: application/json
object

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get Team Standings

Retrieves comprehensive team standings for a specific season, season type, and week. Returns detailed standings information including division, conference, home/away records, win percentages, points for/against, current streaks, and clinching scenarios. Standings are calculated through the specified week.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number within the season

Responses

Response Schema: application/json
object (Pagination)
season
integer
seasonType
string
Enum: "PRE" "REG" "POST"
week
integer

Current week for standings

Array of objects

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "season": 0,
  • "seasonType": "PRE",
  • "week": 0,
  • "weeks": [
    ]
}

Scores

Real-time scoring and game status endpoints

Get Live Game Scores

Retrieves real-time scores and game status for all games in a specified week. This endpoint updates frequently (15-second cache) to provide live scoring updates during active games. Returns an empty array when no games are currently being played.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number

Responses

Response Schema: application/json
required
Array of objects (LiveGame)

Array of live game data (empty when no games are active)

season
required
string

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

week
required
string

Week number

Response samples

Content type
application/json
{
  • "games": [
    ],
  • "season": "2025",
  • "seasonType": "REG",
  • "week": "4"
}

Season Schedule

Season weeks and bye information

Get Season Weeks

Retrieves all weeks for a specific season including preseason, regular season, and postseason weeks. Returns week dates, types, and teams on bye for each week. This endpoint provides a comprehensive season calendar with all scheduling information.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

Responses

Response Schema: application/json
object (Pagination)
season
string

Season year

Array of objects (Week)

Response samples

Content type
application/json
{
  • "pagination": {
    },
  • "season": "2025",
  • "weeks": [
    ]
}

Secured Videos

Premium coaches film video content with multiple camera angles

Get Coaches Film Videos

Retrieves premium coaches film video content for specified games and plays. Returns multiple camera angles (endzone, sideline, broadcast) for each play, providing comprehensive film study material. Requires NFL Plus Premium subscription and appropriate geographic restrictions apply (US only).

Authorizations:
BearerAuth
query Parameters
gameId
required
Array of strings <uuid> [ 1 .. 10 ] items [ items <uuid > ]
Example: gameId=f665fc10-311e-11f0-b670-ae1250fadad1&gameId=ae9d66f7-1312-11ef-afd1-646009f18b2e

Game identifiers (UUID format, supports multiple games)

playId
required
Array of strings [ 1 .. 50 ] items
Example: playId=267&playId=1162&playId=496&playId=139

Play identifiers for specific plays within the games

Responses

Response Schema: application/json
required
Array of objects (CoachesFilmVideo)
required
object (ResponseMetadata)
object (Pagination)

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "metadata": {
    },
  • "pagination": {
    }
}

Stats

Comprehensive game and team statistics endpoints

Get Game Boxscore

Retrieves comprehensive boxscore data for a specific game including team statistics, individual player statistics, and scoring summary. Returns empty arrays for future games.

Authorizations:
BearerAuth
query Parameters
gameId
required
string^\d{10}$
Example: gameId=2025092800

Game identifier (10-digit format YYYYMMDDNN)

Responses

Response Schema: application/json
object (TeamBoxscore)
gameId
string

Game identifier

object (TeamBoxscore)
object (BoxscoreSchedule)

Response samples

Content type
application/json
{
  • "away": {
    },
  • "gameId": "2025092800",
  • "home": {
    },
  • "schedule": {
    }
}

Get Team Rankings for Game

Retrieves comprehensive statistical rankings for both teams in a specific game. Returns 300+ statistical categories with rankings for offensive, defensive, and special teams performance.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

awayTeamId
required
string <uuid>
Example: awayTeamId=10403000-5851-f9d5-da45-78365a05b6b0

Away team UUID

homeTeamId
required
string <uuid>
Example: homeTeamId=10403900-8251-6892-d81c-4348525c2d47

Home team UUID

week
required
integer [ 1 .. 18 ]
Example: week=4

Week number

Responses

Response Schema: application/json
object (TeamRankings)
object (TeamRankings)

Response samples

Content type
application/json
{
  • "awayRankings": {
    },
  • "homeRankings": {
    }
}

Get Gamecenter Statistics

Retrieves advanced game statistics including passer zones, receiver separation, pass rush metrics, and performance leaders for a specific game.

Authorizations:
BearerAuth
query Parameters
gameId
required
string
Example: gameId=2025092800

Game identifier

Responses

Response Schema: application/json
object
object
object
object
object
object (GamecenterSchedule)

Response samples

Content type
application/json
{
  • "leaders": {
    },
  • "passRushers": {
    },
  • "passers": {
    },
  • "receivers": {
    },
  • "rushers": {
    },
  • "schedule": {
    }
}

Get Multiple Rankings for All Teams

Retrieves rankings for all 32 NFL teams across multiple specified statistical categories. Allows comparison of teams across up to 5 different statistics simultaneously.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

stat0
required
string
Example: stat0=scoring-averagePointsScored

First statistical category

stat1
string
Example: stat1=offense-yardsPerGame

Second statistical category

stat2
string
Example: stat2=offense-rushYardsPerGame

Third statistical category

stat3
string
Example: stat3=offense-passYardsPerGame

Fourth statistical category

stat4
string
Example: stat4=misc-netTurnovers

Fifth statistical category

Responses

Response Schema: application/json
Array
object
statCategory
string

Category of statistic

statName
string

Name of specific statistic

Array of objects (TeamRankingEntry)

Response samples

Content type
application/json
[
  • {
    }
]

Get passing statistics

Returns passing statistics for quarterbacks

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer
Example: week=4

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
filter
string
threshold
integer
Array of objects (PassingStat)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "filter": "string",
  • "threshold": 0,
  • "stats": [
    ]
}

Get receiving statistics

Returns receiving statistics for receivers

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
threshold
integer
Array of objects (ReceivingStat)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "threshold": 0,
  • "stats": [
    ]
}

Get rushing statistics

Returns rushing statistics for ball carriers

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025
seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG
week
integer

Optional week filter

Responses

Response Schema: application/json
season
integer
seasonType
string
filter
string
threshold
integer
Array of objects (RushingStat)

Response samples

Content type
application/json
{
  • "season": 0,
  • "seasonType": "string",
  • "filter": "string",
  • "threshold": 0,
  • "stats": [
    ]
}

Team Defense Pass Statistics

Comprehensive team defensive pass statistics and situational analytics

Get Team Defense Pass Statistics by Season

Retrieves comprehensive pass defense statistics for NFL teams during a specified season. Returns detailed metrics including traditional defensive stats, advanced analytics like EPA and YACOE (Yards After Catch Over Expected), Next Gen Stats data, and situational performance breakdowns. Supports various sorting options and includes pressure rates, coverage metrics, quarterback disruption stats, and receiver separation allowed.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "passYpg"
Enum: "total" "pass" "passPct" "passTd" "passYds" "passYpp" "epaPass" "epaPassPP" "ttt" "qbp" "qbpPct" "sackedYds" "sack" "sackPct" "ttp" "blitzPct" "yac" "yacoe" "sep" "go" "passYpg" "sackedYpg"
Example: sortKey=passYpg

Field to sort by

sortValue
string
Default: "ASC"
Enum: "ASC" "DESC"
Example: sortValue=ASC

Sort direction

Responses

Response Schema: application/json
required
Array of objects (TeamDefensePassStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "defense": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "passYpg",
  • "sortValue": "ASC",
  • "total": 32
}

Team Defense Rush Statistics

Comprehensive team defensive rush statistics and situational analytics

Get Team Defense Rush Statistics by Season

Retrieves comprehensive rush defense statistics for NFL teams during a specified season. Returns detailed metrics including traditional run defense stats, advanced analytics like EPA and RYOE (Rush Yards Over Expected), Next Gen Stats data, and situational performance breakdowns. Supports various sorting options and includes stuff rates, gap analysis, box count distributions, and directional rush defense metrics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "rushYpg"
Enum: "total" "run" "runPct" "rushTd" "rushYds" "rushYpp" "epaRush" "epaRushPP" "rush10PYds" "stuffPct" "ryoe" "ryoeAtt" "ybcoAtt" "yacoAtt" "inPct" "outPct" "lightPct" "stackedPct" "rushYpg"
Example: sortKey=rushYpg

Field to sort by

sortValue
string
Default: "ASC"
Enum: "ASC" "DESC"
Example: sortValue=ASC

Sort direction

Responses

Response Schema: application/json
required
Array of objects (TeamDefenseRushStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "defense": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "rushYpg",
  • "sortValue": "ASC",
  • "total": 32
}

Team Defense Statistics

Comprehensive team defensive statistics and situational analytics

Get Team Defense Statistics by Season

Retrieves comprehensive defensive statistics for NFL teams during a specified season. Returns detailed metrics including traditional defensive stats, advanced analytics like EPA and RYOE, Next Gen Stats data, and situational performance breakdowns. Supports filtering by various defensive situations including personnel packages (Base, Nickel, Dime), game situations (leading, trailing, tied), field positions (red zone, goal-to-go), and offensive formations faced (shotgun, under center, pistol, motion).

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "ypg"
Enum: "total" "pass" "run" "yds" "passPct" "ypp" "td" "passTd" "rushTd" "epa" "epaPP" "passYds" "passYpp" "epaPass" "epaPassPP" "rushYds" "rushYpp" "epaRush" "epaRushPP" "ttt" "qbp" "qbpPct" "sackedYds" "ryoe" "interception" "forcedFumble" "fumbleRecovered" "defensiveTouchdown" "totalTakeaways" "ppg" "ypg" "passYpg" "rushYpg" "sackedYpg"
Example: sortKey=ypg

Field to sort by

sortValue
string
Default: "ASC"
Enum: "ASC" "DESC"
Example: sortValue=ASC

Sort direction

split
Array of strings
Items Enum: "TEAM_DEFENSE_BASE" "TEAM_DEFENSE_NICKEL" "TEAM_DEFENSE_DIME" "TEAM_DEFENSE_WHEN_LEADING" "TEAM_DEFENSE_WHEN_TRAILING" "TEAM_DEFENSE_WHEN_TIED" "TEAM_DEFENSE_RED_ZONE" "TEAM_DEFENSE_GOAL_TO_GO" "TEAM_DEFENSE_SHOTGUN" "TEAM_DEFENSE_UNDER_CENTER" "TEAM_DEFENSE_PISTOL" "TEAM_DEFENSE_MOTION"
Example: split=TEAM_DEFENSE_NICKEL&split=TEAM_DEFENSE_RED_ZONE

Defensive situation splits to filter by (supports multiple values)

Responses

Response Schema: application/json
required
Array of objects (TeamDefenseStats)
limit
required
integer

Maximum number of results returned

offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

split
Array of strings

Applied defensive situation splits

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "defense": [
    ],
  • "limit": 35,
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "ypg",
  • "sortValue": "ASC",
  • "split": [
    ],
  • "total": 32
}

Team Offense Overview Statistics

Comprehensive team offensive overview statistics and situational analytics

Get Team Offense Overview Statistics by Season

Retrieves comprehensive offensive overview statistics for NFL teams during a specified season. Returns detailed metrics including traditional offensive stats, advanced analytics like EPA and efficiency ratings, Next Gen Stats data, and situational performance breakdowns. Supports filtering by various offensive situations including formations (shotgun, under center, pistol), game situations (leading, trailing, tied), and field positions (red zone, goal-to-go). Includes total offense, passing offense, rushing offense, and scoring metrics.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "ypg"
Enum: "total" "pass" "run" "yds" "passPct" "ypp" "td" "passTd" "rushTd" "epa" "epaPP" "passYds" "passYpp" "epaPass" "epaPassPP" "rushYds" "rushYpp" "epaRush" "epaRushPP" "to" "ppg" "ypg" "passYpg" "rushYpg" "redZonePct" "thirdDownPct"
Example: sortKey=ypg

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

teamDefense
string
Example: teamDefense=2250

Filter by specific team identifier

split
Array of strings
Items Enum: "TEAM_SHOTGUN" "TEAM_UNDER_CENTER" "TEAM_PISTOL" "TEAM_WHEN_LEADING" "TEAM_WHEN_TRAILING" "TEAM_WHEN_TIED" "TEAM_RED_ZONE" "TEAM_GOAL_TO_GO"
Example: split=TEAM_WHEN_LEADING

Offensive situation splits to filter by (supports multiple values)

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

required
Array of objects (TeamOffenseOverviewStats)
offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

split
Array of strings

Applied offensive situation splits

teamDefense
string

Team filter applied (if any)

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "limit": 35,
  • "offense": [
    ],
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "ypg",
  • "sortValue": "DESC",
  • "split": [
    ],
  • "teamDefense": "2250",
  • "total": 0
}

Team Offense Pass Statistics

Comprehensive team offensive pass statistics and situational analytics

Get Team Offense Pass Statistics by Season

Retrieves comprehensive pass offense statistics for NFL teams during a specified season. Returns detailed metrics including traditional offensive stats, advanced analytics like EPA and YACOE (Yards After Catch Over Expected), Next Gen Stats data, and situational performance breakdowns. Supports various sorting options and includes pressure rates, quarterback metrics, completion rates, and receiver separation data.

Authorizations:
BearerAuth
query Parameters
season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

limit
integer [ 1 .. 100 ]
Default: 35
Example: limit=35

Maximum number of teams to return

offset
integer >= 0
Default: 0
Example: offset=0

Number of records to skip for pagination

page
integer >= 1
Default: 1
Example: page=1

Page number for pagination

sortKey
string
Default: "passYpg"
Enum: "total" "pass" "passPct" "passTd" "passYds" "passYpp" "epaPass" "epaPassPP" "ttt" "qbp" "qbpPct" "att" "sackedYds" "sack" "sackPct" "ttp" "blitzPct" "paPct" "yac" "yacoe" "sep" "passYpg" "sackedYpg"
Example: sortKey=passYpg

Field to sort by

sortValue
string
Default: "DESC"
Enum: "ASC" "DESC"
Example: sortValue=DESC

Sort direction

teamDefense
string
Example: teamDefense=2250

Filter by specific team ID

Responses

Response Schema: application/json
limit
required
integer

Maximum number of results returned

required
Array of objects (TeamOffensePassStats)
offset
required
integer

Number of records skipped

season
required
integer

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"

Type of season

sortKey
required
string

Field used for sorting

sortValue
required
string
Enum: "ASC" "DESC"

Sort direction

teamDefense
string

Applied team filter (if any)

total
required
integer

Total number of teams matching the criteria

Response samples

Content type
application/json
{
  • "limit": 35,
  • "offense": [
    ],
  • "offset": 0,
  • "season": 2025,
  • "seasonType": "REG",
  • "sortKey": "passYpg",
  • "sortValue": "DESC",
  • "teamDefense": "2250",
  • "total": 3
}

Teams

Team information, rosters, and schedules

Get All Teams

Retrieves information for all NFL teams including regular teams and Pro Bowl teams. Returns comprehensive team data including colors, logos, stadiums, and contact information.

Authorizations:
BearerAuth

Responses

Response Schema: application/json
Array
abbr
string

Three-letter team abbreviation

altColor
string

Alternate team color in hex format

city
string

Team city/location

cityState
string

Team city and state

object (Conference)
conferenceAbbr
string
Enum: "AFC" "NFC"

Conference abbreviation

darkColor
string

Dark team color in hex format

object (Division)
domain
string

Team website domain prefix

fullName
string

Full team name

isProBowl
boolean
Default: false

Whether this is a Pro Bowl team

logo
string <uri>

URL to team logo (may contain formatInstructions placeholder)

name
string

Team name

nick
string

Team nickname (short form)

nickname
string

Team nickname

primaryColor
string

Primary team color in hex format

season
integer

Current season year

secondaryColor
string

Secondary team color in hex format

slug
string

URL-friendly team identifier

smartId
string <uuid>

Unique smart identifier for the team

stadiumName
string

Name of the team's home stadium

teamId
string

Team identifier (4-digit string)

teamSiteTicketUrl
string or null <uri>

URL to team's ticket purchase page

teamSiteUrl
string or null <uri>

Team's official website URL

teamType
string
Enum: "TEAM" "PRO"

Type of team (regular or Pro Bowl)

tertiaryColor
string

Tertiary team color in hex format

ticketPhoneNumber
string or null

Phone number for ticket purchases

yearFound
integer

Year the team was founded

Response samples

Content type
application/json
[
  • {
    }
]

Get Team Roster

Retrieves the complete roster for a specific team and season. Returns detailed player information including physical attributes, college info, and experience.

Authorizations:
BearerAuth
query Parameters
teamId
required
string
Example: teamId=3000

Team identifier (4-digit string)

season
required
integer
Example: season=2025

Season year

Responses

Response Schema: application/json
season
integer

Season year

object (TeamInfo)

Basic team information included in roster responses

Array of objects (Player)

Response samples

Content type
application/json
{
  • "season": 2025,
  • "team": {
    },
  • "teamPlayers": [
    ]
}

Get Weekly Team Roster

Retrieves the roster for a specific team, season, season type, and week. Returns player information with weekly status and availability.

Authorizations:
BearerAuth
query Parameters
teamId
required
string
Example: teamId=3900

Team identifier (4-digit string)

season
required
integer
Example: season=2025

Season year

seasonType
required
string
Enum: "PRE" "REG" "POST"
Example: seasonType=REG

Type of season

week
required
integer [ 1 .. 18 ]
Example: week=3

Week number within the season

Responses

Response Schema: application/json
season
integer

Season year

seasonType
string
Enum: "PRE" "REG" "POST"

Type of season

object (TeamInfo)

Basic team information included in roster responses

Array of objects (WeeklyPlayer)
week
integer

Week number

Response samples

Content type
application/json
{
  • "season": 2025,
  • "seasonType": "PRE",
  • "team": {
    },
  • "teamPlayers": [
    ],
  • "week": 3
}

Get Team Schedule

Retrieves the complete schedule for a specific team and season. Returns all games including preseason, regular season, and postseason with scores for completed games.

Authorizations:
BearerAuth
query Parameters
teamId
required
string
Example: teamId=3000

Team identifier (4-digit string)

season
required
integer
Example: season=2025

Season year

Responses

Response Schema: application/json
Array
gameDate
string or null <date>

Game date (YYYY-MM-DD format)

gameId
integer

Game identifier (format is YYYYMMDDNN)

gameKey
integer

Unique game key

gameTime
string or null <date-time>

Game time in UTC

gameTimeEastern
string or null

Game time in Eastern timezone (HH:MM:SS)

gameType
string
Enum: "PRE" "REG" "POST"

Type of game

homeDisplayName
string

Home team display name

homeNickname
string

Home team nickname

object (ScheduleTeam)
homeTeamAbbr
string

Home team abbreviation

homeTeamId
string

Home team identifier

isoTime
integer or null

Unix timestamp in milliseconds

networkChannel
string or null

Broadcast network

ngsGame
boolean

Whether Next Gen Stats are available

releasedToClubs
boolean

Whether game info is released to clubs

object (GameScore)
season
integer

Season year

seasonType
string
Enum: "PRE" "REG" "POST"
object (GameSite)
smartId
string <uuid>

Smart identifier for the game

validated
boolean

Whether game info is validated

visitorDisplayName
string

Visitor team display name

visitorNickname
string

Visitor team nickname

object (ScheduleTeam)
visitorTeamAbbr
string

Visitor team abbreviation

visitorTeamId
string

Visitor team identifier

week
integer

Week number

weekNameAbbr
string

Week name abbreviation

Response samples

Content type
application/json
[
  • {
    }
]

Win Probability

Game and play-level win probability analytics

Get Game Win Probability by Plays

Retrieves comprehensive win probability data for every play in specified games. Returns pre-game win probabilities and detailed play-by-play probability changes, including Win Probability Added (WPA) metrics for each play. This advanced analytics endpoint tracks how each play impacts the probability of each team winning the game. Supports querying multiple games simultaneously.

Authorizations:
BearerAuth
query Parameters
required
string or Array of strings
Examples:
  • gameId=2025092800&gameId=2025092104 - Multiple games
  • gameId=2025092800 - Single game

Game identifier(s) in 10-digit format (YYYYMMDDNN). Can be a single game ID or multiple game IDs for batch retrieval.

Responses

Response Schema: application/json
One of
gameId
required
integer

Game identifier (10-digit format YYYYMMDDNN)

gameKey
required
integer

Unique game key identifier

required
Array of objects (PlayWinProbability)

Chronological list of all plays with win probability data

pregameAwayTeamWinProbability
required
number <float> [ 0 .. 1 ]

Away team's win probability before the game started

pregameHomeTeamWinProbability
required
number <float> [ 0 .. 1 ]

Home team's win probability before the game started

Response samples

Content type
application/json
[ ]

Get Minimal Win Probability Data

Retrieves minimal win probability data for specified games, including pregame win probabilities and play-by-play probability changes throughout the game. This endpoint provides essential win probability metrics with optimized data structure for performance. Supports multiple games in a single request.

Authorizations:
BearerAuth
query Parameters
fapiGameId
required
Array of strings <uuid> [ 1 .. 50 ] items [ items <uuid > ]
Example: fapiGameId=f666051f-311e-11f0-b670-ae1250fadad1&fapiGameId=f6660056-311e-11f0-b670-ae1250fadad1&fapiGameId=f665fc10-311e-11f0-b670-ae1250fadad1

Football API game identifiers (UUID format). Supports multiple game IDs to retrieve win probability data for multiple games simultaneously.

Responses

Response Schema: application/json
gameId
required
integer

Game identifier (10-digit format YYYYMMDDNN)

gameKey
required
integer

Unique game key identifier

required
Array of objects (PlayWinProbability)

Chronological list of all plays with win probability data

pregameAwayTeamWinProbability
required
number <float> [ 0 .. 1 ]

Away team's win probability before the game started

pregameHomeTeamWinProbability
required
number <float> [ 0 .. 1 ]

Home team's win probability before the game started

Response samples

Content type
application/json
{
  • "gameId": 2025092106,
  • "gameKey": 59882,
  • "plays": [
    ],
  • "pregameAwayTeamWinProbability": 0.28824037592858076,
  • "pregameHomeTeamWinProbability": 0.7117596240714192
}