Categories

Coverage
Game Statuses
Player Statuses
Play Types & Details
Standings
Injuries
Subjective Statistics
Drives
Scoring
Pulse Data

Integration
Data Workflow
Season Types
Player Positions
Transactions
Officials
Statistics
NFL Draft
Venues
Schedules

.

Coverage

How is each NFL game covered?

Coverage information for the NFL can be found here.

Do you cover the Pro Bowl?

No. We do not currently cover the Pro Bowl in the NFL API.

Integration

How can I get started with my integration?

Set up an account, learn the NFL API basics, study our game workflows, tackle in-depth integration scenarios, and more by visiting our NFL v7 Integration Guide!

Are simulations available for this API?

Yes! You can replay past games as though they were live using our on-demand Simulations service.

What format are date fields presented in?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or cache-control: public, must-revalidate, max-age=120

Game Statuses

What are the game statuses and their descriptions?

Here are the valid game statuses and their descriptions:

Data Workflow

How can I find timings for data entry updates?

Our NFL Data Entry Workflow section covers data availability updates. This includes updates for transactions, rankings, depth charts, stat validation, and more.

How do you represent coin tosses in the Game Play-by-Play?

A coin toss entry (coin_toss) will appear in each game immediately following the 1st quarter, 3rd quarter, and overtime elements. The 3rd quarter coin_toss object represents an inverse of the teams' decisions at the beginning of the game.

Within the coin_toss object are entries for outcome, decision, and direction for the home and away teams. The coin toss winner (outcome=“won”) may choose to either defer (decision=“defer”), kick (decision=“kick”), or receive (decision=“receive”). The team that decides to defer or kick in the period is the team electing which end of the field they wish to defend. Defending directions are north, south, east, and west (ex. direction=“south”).

Please note that the direction property may not always be available.

<coin_toss>
  <home outcome="won" decision="defer" direction="south"/>
  <away outcome="lost" decision="receive" direction="south"/>
</coin_toss>

<game xmlns="http://feed.elasticstats.com/schema/football/pbp-v7.0.xsd" id="3bb41c33-5d92-46c5-8954-dea91ef6dc0e" status="closed" scheduled="2023-12-03T21:25:00+00:00" attendance="72887" entry_mode="LDE" clock="00:00" quarter="4" sr_id="sr:match:41209527" game_type="regular" conference_game="false" duration="3:20">
  <summary>
    <season id="a538d200-e916-4272-aa07-b486094a1668" year="2023" type="REG" name="REG"/>
    <week id="0796e6a9-84ca-4651-9813-bc8bb391ad95" sequence="13" title="13"/>
    <venue id="790c1f04-73c6-4f6f-8b1e-78a62260be90" name="SoFi Stadium" city="Inglewood" state="CA" country="USA" zip="90301" address="1000 S Prairie Ave" capacity="70240" surface="artificial" roof_type="outdoor" sr_id="sr:venue:52183">
      <location lat="33.953536" lng="-118.338734"/>
    </venue>
    <home id="2eff2a03-54d4-46ba-890e-2bc3925548f3" name="Rams" market="Los Angeles" alias="LA" sr_id="sr:competitor:4387" used_timeouts="0" remaining_timeouts="3" points="36" used_challenges="2" remaining_challenges="0">
      <record wins="10" losses="7" ties="0"/>
    </home>
    <away id="d5a2eb42-8065-4174-ab79-0a6fa820e35e" name="Browns" market="Cleveland" alias="CLE" sr_id="sr:competitor:4417" used_timeouts="3" remaining_timeouts="0" points="19" used_challenges="1" remaining_challenges="1">
      <record wins="11" losses="6" ties="0"/>
    </away>
  </summary>
  <quarter id="1a8ded1c-0adc-486c-a034-5fa36c5d2a52" number="1" sequence="1">
    <scoring>
      <home id="2eff2a03-54d4-46ba-890e-2bc3925548f3" name="Rams" market="Los Angeles" alias="LA" sr_id="sr:competitor:4387" points="10"/>
      <away id="d5a2eb42-8065-4174-ab79-0a6fa820e35e" name="Browns" market="Cleveland" alias="CLE" sr_id="sr:competitor:4417" points="7"/>
    </scoring>
    <coin_toss>
      <home outcome="won" decision="defer" direction="south"/>
      <away outcome="lost" decision="receive" direction="south"/>
    </coin_toss>
    <play-by-play>
      <drive id="a5c50761-a5c7-4177-b185-53cf857b31c2" sequence="1"/>
---snip---      
      <event id="11030480-9230-11ee-a2a3-8db1c4f06774" sequence="1701644570138.0" clock="00:00" created_at="2023-12-03T23:02:50+00:00" updated_at="2023-12-03T23:02:50+00:00" wall_clock="2023-12-03T23:02:48+00:00" type="period_end">
        <description>End Quarter 2</description>
      </event>
    </play-by-play>
  </quarter>
  <quarter id="a2d75823-2e73-4dd1-99ec-19fe5a8940ae" number="3" sequence="3">
    <scoring>
      <home id="2eff2a03-54d4-46ba-890e-2bc3925548f3" name="Rams" market="Los Angeles" alias="LA" sr_id="sr:competitor:4387" points="7"/>
      <away id="d5a2eb42-8065-4174-ab79-0a6fa820e35e" name="Browns" market="Cleveland" alias="CLE" sr_id="sr:competitor:4417" points="3"/>
    </scoring>
    <coin_toss>
      <home outcome="won" decision="receive" direction="north"/>
      <away outcome="lost" decision="kick" direction="north"/>
    </coin_toss>

{
    "id": "3bb41c33-5d92-46c5-8954-dea91ef6dc0e",
    "status": "closed",
    "scheduled": "2023-12-03T21:25:00+00:00",
    "attendance": 72887,
    "entry_mode": "LDE",
    "clock": "00:00",
    "quarter": 4,
    "sr_id": "sr:match:41209527",
    "game_type": "regular",
    "conference_game": false,
    "duration": "3:20",
    "summary":
    {
        "season":
        {
            "id": "a538d200-e916-4272-aa07-b486094a1668",
            "year": 2023,
            "type": "REG",
            "name": "REG"
        },
        "week":
        {
            "id": "0796e6a9-84ca-4651-9813-bc8bb391ad95",
            "sequence": 13,
            "title": "13"
        },
        "home":
        {
            "id": "2eff2a03-54d4-46ba-890e-2bc3925548f3",
            "name": "Rams",
            "market": "Los Angeles",
            "alias": "LA",
            "sr_id": "sr:competitor:4387",
            "used_timeouts": 0,
            "remaining_timeouts": 3,
            "points": 36,
            "used_challenges": 2,
            "remaining_challenges": 0,
            "record":
            {
                "wins": 10,
                "losses": 7,
                "ties": 0
            }
        },
        "away":
        {
            "id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e",
            "name": "Browns",
            "market": "Cleveland",
            "alias": "CLE",
            "sr_id": "sr:competitor:4417",
            "used_timeouts": 3,
            "remaining_timeouts": 0,
            "points": 19,
            "used_challenges": 1,
            "remaining_challenges": 1,
            "record":
            {
                "wins": 11,
                "losses": 6,
                "ties": 0
            }
        }
    },
    "periods":
    [
        {
            "period_type": "quarter",
            "id": "1a8ded1c-0adc-486c-a034-5fa36c5d2a52",
            "number": 1,
            "sequence": 1,
            "scoring":
            {
                "home":
                {
                    "id": "2eff2a03-54d4-46ba-890e-2bc3925548f3",
                    "name": "Rams",
                    "market": "Los Angeles",
                    "alias": "LA",
                    "sr_id": "sr:competitor:4387",
                    "points": 10
                },
                "away":
                {
                    "id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e",
                    "name": "Browns",
                    "market": "Cleveland",
                    "alias": "CLE",
                    "sr_id": "sr:competitor:4417",
                    "points": 7
                }
            },
            "coin_toss":
            {
                "home":
                {
                    "outcome": "won",
                    "decision": "defer",
                    "direction": "south"
                },
                "away":
                {
                    "outcome": "lost",
                    "decision": "receive",
                    "direction": "south"
                }
            },
---snip---           
        {
            "period_type": "quarter",
            "id": "a2d75823-2e73-4dd1-99ec-19fe5a8940ae",
            "number": 3,
            "sequence": 3,
            "scoring":
            {
                "home":
                {
                    "id": "2eff2a03-54d4-46ba-890e-2bc3925548f3",
                    "name": "Rams",
                    "market": "Los Angeles",
                    "alias": "LA",
                    "sr_id": "sr:competitor:4387",
                    "points": 7
                },
                "away":
                {
                    "id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e",
                    "name": "Browns",
                    "market": "Cleveland",
                    "alias": "CLE",
                    "sr_id": "sr:competitor:4417",
                    "points": 3
                }
            },
            "coin_toss":
            {
                "home":
                {
                    "outcome": "won",
                    "decision": "receive",
                    "direction": "north"
                },
                "away":
                {
                    "outcome": "lost",
                    "decision": "kick",
                    "direction": "north"
                }
            },
            "pbp":
            [
                {
                    "type": "drive",
                    "id": "e7036061-9048-4b8c-b665-bd68374462dc",
                    "sequence": 15,
                    "start_reason": "Kickoff",
                    "end_reason": "Punt",
                    "play_count": 4,
                    "duration": "2:28",
                    "first_downs": 1,
                    "gain": 25,
                    "penalty_yards": 0,
                    "created_at": "2023-12-03T23:16:23+00:00",
                    "updated_at": "2023-12-03T23:21:23+00:00",
                    "team_sequence": 8,
                    "start_clock": "15:00",
                    "end_clock": "12:32",
                    "first_drive_yardline": 83,
                    "last_drive_yardline": 58,
                    "farthest_drive_yardline": 58,
                    "net_yards": 25,
                    "pat_points_attempted": 0,
                    "offensive_team":
                    {
                        "points": 0,
                        "id": "2eff2a03-54d4-46ba-890e-2bc3925548f3"
                    },
                    "defensive_team":
                    {
                        "points": 0,
                        "id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e"
                    },
                    "events":
                    [
                        {
                            "type": "play",
                            "id": "15340400-9230-11ee-a2a3-8db1c4f06774",
                            "sequence": 1701645383357,
                            "clock": "15:00",
                            "home_points": 13,
                            "away_points": 10,
                            "play_type": "kickoff",
                            "wall_clock": "2023-12-03T23:16:12+00:00",
                            "description": "D.Hopkins kicks 56 yards from CLE 35 to the LA 9. A.Trammell returns the kickoff. Tackled by K.Hailassie at LA 17.",
                            "fake_punt": false,
                            "fake_field_goal": false,
                            "screen_pass": false,
                            "hash_mark": "Right Hash",
                            "play_action": false,
                            "run_pass_option": false,
                            "created_at": "2023-12-03T23:16:23+00:00",
                            "updated_at": "2023-12-04T21:01:45+00:00",
                            "start_situation":
                            {
                                "clock": "15:00",
                                "down": 0,
                                "yfd": 0,
                                "possession":
                                {
                                    "id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e",
                                    "name": "Browns",
                                    "market": "Cleveland",
                                    "alias": "CLE",
                                    "sr_id": "sr:competitor:4417"
                                },
                                "location":
                                {
                                    "id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e",
                                    "name": "Browns",
                                    "market": "Cleveland",
                                    "alias": "CLE",
                                    "sr_id": "sr:competitor:4417",
                                    "yardline": 35
                                }
                            },
                            "end_situation":
                            {
                                "clock": "14:55",
                                "down": 1,
                                "yfd": 10,
                                "possession":
                                {
                                    "id": "2eff2a03-54d4-46ba-890e-2bc3925548f3",
                                    "name": "Rams",
                                    "market": "Los Angeles",
                                    "alias": "LA",
                                    "sr_id": "sr:competitor:4387"
                                },
                                "location":
                                {
                                    "id": "2eff2a03-54d4-46ba-890e-2bc3925548f3",
                                    "name": "Rams",
                                    "market": "Los Angeles",
                                    "alias": "LA",
                                    "sr_id": "sr:competitor:4387",
                                    "yardline": 17
                                }
                            },
                            "statistics":
                            [
                                {
                                    "stat_type": "kick",
                                    "attempt": 1,
                                    "yards": 56,
                                    "net_yards": 48,
                                    "inside_20": 1,
                                    "onside_attempt": 0,
                                    "onside_success": 0,
                                    "squib_kick": 0,
                                    "player":
                                    {
                                        "id": "058c99fc-470c-4579-a165-03e043335cc1",
                                        "name": "Dustin Hopkins",
                                        "jersey": "07",
                                        "position": "K",
                                        "sr_id": "sr:player:828769"
                                    },
                                    "team":
                                    {
                                        "id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e",
                                        "name": "Browns",
                                        "market": "Cleveland",
                                        "alias": "CLE",
                                        "sr_id": "sr:competitor:4417"
                                    }
                                },
                                {
                                    "stat_type": "return",
                                    "return": 1,
                                    "yards": 8,
                                    "category": "kick_return",
                                    "player":
                                    {
                                        "id": "c1d52f55-4c65-4b37-8457-f0dc028c85bc",
                                        "name": "Austin Trammell",
                                        "jersey": "81",
                                        "position": "WR",
                                        "sr_id": "sr:player:2198468"
                                    },
                                    "team":
                                    {
                                        "id": "2eff2a03-54d4-46ba-890e-2bc3925548f3",
                                        "name": "Rams",
                                        "market": "Los Angeles",
                                        "alias": "LA",
                                        "sr_id": "sr:competitor:4387"
                                    }
                                },
                                {
                                    "stat_type": "defense",
                                    "tackle": 1,
                                    "category": "special_team",
                                    "missed_tackles": 0,
                                    "def_target": 0,
                                    "def_comp": 0,
                                    "blitz": 0,
                                    "hurry": 0,
                                    "knockdown": 0,
                                    "batted_pass": 0,
                                    "player":
                                    {
                                        "id": "d470e520-f421-11ed-990e-333ce5b07033",
                                        "name": "Kahlef Hailassie",
                                        "jersey": "25",
                                        "position": "CB",
                                        "sr_id": "sr:player:1472984"
                                    },
                                    "team":
                                    {
                                        "id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e",
                                        "name": "Browns",
                                        "market": "Cleveland",
                                        "alias": "CLE",
                                        "sr_id": "sr:competitor:4417"
                                    }
                                }
                            ],
                            "details":
                            [
                                {
                                    "category": "kick_off",
                                    "description": "D.Hopkins kicks 56 yards from CLE 35 to the LA 9.",
                                    "sequence": 0,
                                    "yards": 56,
                                    "result": "returned",
                                    "start_location":
                                    {
                                        "alias": "CLE",
                                        "yardline": 35
                                    },
                                    "end_location":
                                    {
                                        "alias": "LA",
                                        "yardline": 9
                                    },
                                    "players":
                                    [
                                        {
                                            "id": "058c99fc-470c-4579-a165-03e043335cc1",
                                            "name": "Dustin Hopkins",
                                            "jersey": "07",
                                            "position": "K",
                                            "sr_id": "sr:player:828769",
                                            "role": "kick"
                                        }
                                    ]
                                },
                                {
                                    "category": "kick_off_return",
                                    "description": "A.Trammell returns the kickoff.",
                                    "sequence": 1,
                                    "yards": 8,
                                    "result": "tackled",
                                    "start_location":
                                    {
                                        "alias": "LA",
                                        "yardline": 9
                                    },
                                    "end_location":
                                    {
                                        "alias": "LA",
                                        "yardline": 17
                                    },
                                    "players":
                                    [
                                        {
                                            "id": "058c99fc-470c-4579-a165-03e043335cc1",
                                            "name": "Dustin Hopkins",
                                            "jersey": "07",
                                            "position": "K",
                                            "sr_id": "sr:player:828769",
                                            "role": "kick"
                                        },
                                        {
                                            "id": "c1d52f55-4c65-4b37-8457-f0dc028c85bc",
                                            "name": "Austin Trammell",
                                            "jersey": "81",
                                            "position": "WR",
                                            "sr_id": "sr:player:2198468",
                                            "role": "return"
                                        }
                                    ]
                                },
                                {
                                    "category": "tackle",
                                    "description": "Tackled by K.Hailassie at LA 17.",
                                    "sequence": 2,
                                    "start_location":
                                    {
                                        "alias": "LA",
                                        "yardline": 17
                                    },
                                    "end_location":
                                    {
                                        "alias": "LA",
                                        "yardline": 17
                                    },
                                    "players":
                                    [
                                        {
                                            "id": "d470e520-f421-11ed-990e-333ce5b07033",
                                            "name": "Kahlef Hailassie",
                                            "jersey": "25",
                                            "position": "CB",
                                            "sr_id": "sr:player:1472984",
                                            "role": "tackle"
                                        }
                                    ]
                                }
                            ]
                        },

Season Types

What are the season types and their descriptions?

Here are the valid season types and their descriptions:

PRE – Pre-season
REG – Regular season
PST – Post-season

Player Statuses

What are the player statuses and their descriptions?

Below is a list of the currently valid player statuses and their descriptions. Note that additional decommissioned statuses may appear in older seasons.

ACT - Active
DUP - Duplicate player profile. All profiles marked as duplicates can be ignored.
EXE - Exempt
FRES - Reserve/Future
IR - Injured Reserve
IRD - Injured Reserve - Designated for Return
NON - Non-football related injured reserve
NWT - Not with team
PRA - Practice Squad
PRA_IR - Practice Squad Injured Reserve
PUP - Physically unable to perform
RET - Retired
SUS - Suspended
UDF - Unsigned draft pick
UFA - Unsigned free agent

What are the player game statuses and when can I expect them to populate?

Below is a list of currently valid player game statuses.

deactivated
dnp (Did Not Play)
played
started

These player game statuses will appear within the Game Roster feed exclusively.

When a game is set to created all players are marked as played. Approximately 90 minutes before kickoff, NFL teams will announce inactive players for their game. At this time, affected players are adjusted to deactivated. At the conclusion of the game players are adjusted to started , played, and dnp as necessary.

<player id="56b26b71-8f1e-416c-a7e5-62cd67c98f4b" name="Matthew Orzech" jersey="42" 
last_name="Orzech" first_name="Matthew" abbr_name="M.Orzech" birth_date="1995-04-12" 
weight="245.0" height="75" position="LS" age="28" birth_place="San Diego, CA, USA" 
high_school="Paloma Valley (CA)" college="Azusa Pacific" college_conf="Great Northwest Athletic Conference" 
rookie_year="2019" status="played" sr_id="sr:player:1737543" in_game_status="active">
</player>
<player id="a93e2eb0-d264-11ec-b16e-cf7159baf83d" name="Zyon Gilbert" jersey="27" 
last_name="Gilbert" first_name="Zyon" abbr_name="Z.Gilbert" birth_date="1999-02-04" 
weight="182.0" height="73" position="CB" age="24" birth_place="Montgomery, AL, USA" 
high_school="Jefferson Davis (AL)" college="Florida Atlantic" college_conf="Conference USA" 
rookie_year="2022" status="dnp" sr_id="sr:player:1236108" in_game_status="active">
</player>
<player id="b5d116d8-11d4-43b1-8f0b-9a3ba26648c9" name="Elgton Jenkins" jersey="74" 
last_name="Jenkins" first_name="Elgton" abbr_name="E.Jenkins" birth_date="1995-12-26" weight="311.0" 
height="77" position="OL" age="27" birth_place="Clarksdale, MS, USA" high_school="Clarksdale (MS)" 
college="Mississippi State" college_conf="Southeastern Conference" rookie_year="2019" 
status="started" sr_id="sr:player:1203480" in_game_status="active">
</player>

{
    "id": "56b26b71-8f1e-416c-a7e5-62cd67c98f4b",
    "name": "Matthew Orzech",
    "jersey": "42",
    "last_name": "Orzech",
    "first_name": "Matthew",
    "abbr_name": "M.Orzech",
    "birth_date": "1995-04-12",
    "weight": 245.0,
    "height": 75,
    "position": "LS",
    "age": 28,
    "birth_place": "San Diego, CA, USA",
    "high_school": "Paloma Valley (CA)",
    "college": "Azusa Pacific",
    "college_conf": "Great Northwest Athletic Conference",
    "rookie_year": 2019,
    "status": "played",
    "sr_id": "sr:player:1737543",
    "in_game_status": "active"
},
{
    "id": "a93e2eb0-d264-11ec-b16e-cf7159baf83d",
    "name": "Zyon Gilbert",
    "jersey": "27",
    "last_name": "Gilbert",
    "first_name": "Zyon",
    "abbr_name": "Z.Gilbert",
    "birth_date": "1999-02-04",
    "weight": 182.0,
    "height": 73,
    "position": "CB",
    "age": 24,
    "birth_place": "Montgomery, AL, USA",
    "high_school": "Jefferson Davis (AL)",
    "college": "Florida Atlantic",
    "college_conf": "Conference USA",
    "rookie_year": 2022,
    "status": "dnp",
    "sr_id": "sr:player:1236108",
    "in_game_status": "active"
},
{
    "id": "b5d116d8-11d4-43b1-8f0b-9a3ba26648c9",
    "name": "Elgton Jenkins",
    "jersey": "74",
    "last_name": "Jenkins",
    "first_name": "Elgton",
    "abbr_name": "E.Jenkins",
    "birth_date": "1995-12-26",
    "weight": 311.0,
    "height": 77,
    "position": "OL",
    "age": 27,
    "birth_place": "Clarksdale, MS, USA",
    "high_school": "Clarksdale (MS)",
    "college": "Mississippi State",
    "college_conf": "Southeastern Conference",
    "rookie_year": 2019,
    "status": "started",
    "sr_id": "sr:player:1203480",
    "in_game_status": "active",
    "draft": {
        "year": 2019,
        "round": 2,
        "number": 44,
        "team": {
            "id": "a20471b4-a8d9-40c7-95ad-90cc30e46932",
            "name": "Packers",
            "market": "Green Bay",
            "alias": "GB",
            "sr_id": "sr:competitor:4420"
        }
    }
},

What are the possible in-game player status updates (`player.in_game_status`) I can expect to see in the Game Roster endpoint?

Here are the valid in-game player statuses we provide:

active
probable
questionable
doubtful
out
benched
unknown

<player id="bbd0942c-6f77-4f83-a6d0-66ec6548019e" name="Kirk Cousins" jersey="08" last_name="Cousins" 
first_name="Kirk" abbr_name="K.Cousins" birth_date="1988-08-19" weight="205.0" height="75" 
position="QB" age="35" birth_place="Barrington, IL, USA" high_school="Holland Christian (MI)" 
college="Michigan State" college_conf="Big Ten Conference" rookie_year="2012" status="started" 
sr_id="sr:player:828891" in_game_status="out">
    <draft year="2012" round="4" number="102">
        <team id="22052ff7-c065-42ee-bc8f-c4691c50e624" name="Commanders" market="Washington" alias="WAS" sr_id="sr:competitor:4432"/>
    </draft>
</player>

{
    "id": "bbd0942c-6f77-4f83-a6d0-66ec6548019e",
    "name": "Kirk Cousins",
    "jersey": "08",
    "last_name": "Cousins",
    "first_name": "Kirk",
    "abbr_name": "K.Cousins",
    "birth_date": "1988-08-19",
    "weight": 205.0,
    "height": 75,
    "position": "QB",
    "age": 35,
    "birth_place": "Barrington, IL, USA",
    "high_school": "Holland Christian (MI)",
    "college": "Michigan State",
    "college_conf": "Big Ten Conference",
    "rookie_year": 2012,
    "status": "started",
    "sr_id": "sr:player:828891",
    "in_game_status": "out",
    "draft": {
        "year": 2012,
        "round": 4,
        "number": 102,
        "team": {
            "id": "22052ff7-c065-42ee-bc8f-c4691c50e624",
            "name": "Commanders",
            "market": "Washington",
            "alias": "WAS",
            "sr_id": "sr:competitor:4432"
        }
    }
},

Player Positions

What are the player positions I can expect to see?

Below is a list of player positions that appear in our feeds and their descriptions. Note that additional decommissioned positions may appear in older seasons.

C - Center
CB - Cornerback
DB - Defensive Back
DE - Defensive End
DL - Defensive Lineman
DT - Defensive Tackle
FB - Fullback
FS - Free Safety
G - Offensive Guard
K - Kicker
LB - Linebacker
LS - Long Snapper
MLB - Middle Linebacker
NT - Nose Tackle
OG - Offensive Guard
OL - Offensive Lineman
OLB - Outside Linebacker
OT - Offensive Tackle
P - Punter
QB - Quarterback
RB - Running Back
SAF - Safety
SS - Strong Safety
T - Offensive Tackle
TE - Tight End
WR - Wide Receiver

How are player positions handled in the feeds?

Players may receive a “game” position, that position may not match the position listed on the player’s profile outside the game.

What coach positions do you display?

Below are the current coach positions currently supported by our API. Please note: these are not fixed enumeration values and may be expanded or updated in the future

Offensive Coordinator
Interim Head Coach
Defensive Coordinator
Head Coach
Special Teams Coordinator
Co-Offensive Coordinator
Assistant Head Coach/Defensive Coordinator
Co-Defensive Coordinator
Interim Defensive Coordinator
Interim Offensive Coordinator

    <coaches>
        <coach id="109f7f41-490e-4adf-a6cb-2591bf886a97" full_name="Brandon Staley" first_name="Brandon" last_name="Staley" position="Defensive Coordinator"/>
        <coach id="1bb0ec40-3be3-11f0-8ad9-dd7f0645615e" full_name="Phil Galiano" first_name="Phil" last_name="Galiano" position="Special Teams Coordinator"/>
        <coach id="65fbdbc0-efad-11ef-bc11-51c2b11c914a" full_name="Doug Nussmeier" first_name="Doug" last_name="Nussmeier" position="Offensive Coordinator"/>
        <coach id="793d9b0d-0b96-4f64-aa8b-f5f7ae72c4ec" full_name="Kellen Moore" first_name="Kellen" last_name="Moore" position="Head Coach"/>
    </coaches>

Play Types & Details

What are the play types I can expect to see?

Here are the valid play types:

pass
rush
faircatch_kick
extra_point
conversion
free_kick
kickoff
punt
field_goal
penalty

What are the event types I can expect to see?

Here are the valid event types:

setup
timeout
tv_timeout
two_minute_warning
comment
period_end
game_over

What are the possible detail categories I can expect to see?

Here are the valid detail categories:

aborted_snap
aborted_snap_recovery
blocked_kick
blocked_kick_recovery
defensive_conversion_fumble_recovery
defensive_conversion_interception_recovery
defensive_conversion_recovery
downed
extra_point_attempt
fair_catch
field_goal
field_goal_return
first_down
forced_fumble
fourth_down_conversion
fumble
fumble_out_of_bounds
kick_off
kick_off_return
kneel
lateral
muffed_kick
muffed_punt
no_play
onside_kick_off
onside_kick_off_recovery
opponent_aborted_snap_recovery
opponent_blocked_kick_recovery
opponent_fumble_recovery
out_of_bounds
own_aborted_snap_recovery
own_blocked_kick_recovery
own_fumble_recovery
pass
pass_completion
pass_incompletion
pass_interception
pass_interception_return
pass_reception
penalty
punt
punt_return
pushed_out_of_bounds
ran_out_of_bounds
review
review_pending
rush
sack
safety
scramble
spike
stat_correction
tackle
team_timeout
third_down_conversion
touchback
touchdown
two_point_attempt
two_point_pass
two_point_return
two_point_result
two_point_rush

<detail category="pass_incompletion" sequence="1" direction="short middle">
    <description>J.Allen pass incomplete short middle intended for D.Knox.</description>
    <start_location alias="BUF" yardline="42"/>
    <end_location alias="BUF" yardline="45"/>
    <players>
        <player id="5fb525c5-4e70-4ede-8c49-94ad0cf66b7d" name="Dawson Knox" jersey="88" position="TE" sr_id="sr:player:1229734" role="receive"/>
        <player id="3069db07-aa43-4503-ab11-2ae5c0002721" name="Josh Allen" jersey="17" position="QB" sr_id="sr:player:1208608" role="pass"/>
    </players>
</detail>

{
    "category": "pass_incompletion",
    "description": "J.Allen pass incomplete short middle intended for D.Knox.",
    "sequence": 1,
    "direction": "short middle",
    "start_location": {
        "alias": "BUF",
        "yardline": 42
    },
    "end_location": {
        "alias": "BUF",
        "yardline": 45
    },
    "players": [
        {
            "id": "5fb525c5-4e70-4ede-8c49-94ad0cf66b7d",
            "name": "Dawson Knox",
            "jersey": "88",
            "position": "TE",
            "sr_id": "sr:player:1229734",
            "role": "receive"
        },
        {
            "id": "3069db07-aa43-4503-ab11-2ae5c0002721",
            "name": "Josh Allen",
            "jersey": "17",
            "position": "QB",
            "sr_id": "sr:player:1208608",
            "role": "pass"
        }
    ]
}

What are the possible player `role` values in play details?

Here are the valid detail categories:

ast_sack
ast_tackle
block
catch
conversion
defend
defender
down
fair_catch
first_down
force_fum
force_fum_ast
fum_rec
fumble
hit
hold
kick
lateral
miss
muff
out_of_bounds
pass
penalty
punt
receive
recovery
return
reviewed_by
rush
sack
safety
snap
tackle
timeout
touchback

<details>
  <detail category="pass" sequence="0">
    <description>B.Purdy steps back to pass.</description>
    <start_location alias="SF" yardline="30"/>
    <end_location alias="SF" yardline="30"/>
    <players>
      <player id="d5aef708-ad61-4ab8-a637-62ff96e92040" name="Brock Purdy" jersey="13" position="QB" sr_id="sr:player:1420461" role="pass"/>
    </players>
  </detail>
  <detail category="pass_incompletion" sequence="1" direction="deep left">
    <description>B.Purdy pass incomplete deep left intended for D.Samuel.</description>
    <start_location alias="SF" yardline="30"/>
    <end_location alias="SF" yardline="47"/>
    <players>
      <player id="628a6a0a-4fde-4024-8d7c-28674953d5af" name="Deebo Samuel Sr." jersey="19" position="WR" sr_id="sr:player:1218302" role="receive"/>
      <player id="d5aef708-ad61-4ab8-a637-62ff96e92040" name="Brock Purdy" jersey="13" position="QB" sr_id="sr:player:1420461" role="pass"/>
    </players>
  </detail>
</details>

"details": [
  {
    "category": "pass_completion",
    "description": "B.Purdy pass short middle complete to KC 46.",
    "sequence": 0,
    "direction": "short middle",
    "yards": 11,
    "start_location": {
      "alias": "SF",
      "yardline": 49
    },
    "end_location": {
      "alias": "KC",
      "yardline": 46
    },
    "players": [
      {
        "id": "d5aef708-ad61-4ab8-a637-62ff96e92040",
        "name": "Brock Purdy",
        "jersey": "13",
        "position": "QB",
        "sr_id": "sr:player:1420461",
        "role": "pass"
      }
    ]
  },
  {
    "category": "pass_reception",
    "description": "Catch made by C.McCaffrey at KC 46. Gain of 11 yards.",
    "sequence": 1,
    "yards": 11,
    "result": "tackled",
    "start_location": {
      "alias": "KC",
      "yardline": 46
    },
    "end_location": {
      "alias": "KC",
      "yardline": 40
    },
    "players": [
      {
        "id": "f96db0af-5e25-42d1-a07a-49b4e065b364",
        "name": "Christian McCaffrey",
        "jersey": "23",
        "position": "RB",
        "sr_id": "sr:player:1129507",
        "role": "catch"
      }
    ]
  },

What are the possible review `type` values in play details?

Below are possible detail - review.type values.

The review/challenge outcome appears under review.result as either overturned or upheld. In cases where a team initiates a challenge (rather than an official review), a team object will appear within review.

backward pass
first down
fumble
illegal forward pass
ineligible receiver
kick touched
loose ball recovery
pass completion
pass interception
potential foul
runner broke the plane
runner was down by contact
running into the kicker
safety
short of the line to gain
targeting
tipped pass
too many players on field
touchback

<play id="a7fddcb0-7e8f-11ef-a8f8-6731672f2233" sequence="1727634146815.0" clock="2:23" home_points="0" away_points="28" wall_clock="2024-09-29T18:22:20+00:00" players_rushed="4" men_in_box="7" fake_punt="false" fake_field_goal="false" screen_pass="false" blitz="false" play_direction="Middle" left_tightends="0" right_tightends="2" hash_mark="Right Hash" pocket_location="Middle" qb_at_snap="Shotgun" huddle="Huddle" pass_route="In" play_action="false" run_pass_option="false" created_at="2024-09-29T18:22:26+00:00" updated_at="2024-09-30T18:17:42+00:00" type="pass">
  <start_situation clock="2:23" down="2" yfd="10">
    <possession id="a20471b4-a8d9-40c7-95ad-90cc30e46932" name="Packers" market="Green Bay" alias="GB" sr_id="sr:competitor:4420"/>
    <location id="33405046-04ee-4058-a950-d606f8c30852" name="Vikings" market="Minnesota" alias="MIN" sr_id="sr:competitor:4423" yardline="34"/>
  </start_situation>
  <end_situation clock="2:16" down="3" yfd="10">
    <possession id="a20471b4-a8d9-40c7-95ad-90cc30e46932" name="Packers" market="Green Bay" alias="GB" sr_id="sr:competitor:4420"/>
    <location id="33405046-04ee-4058-a950-d606f8c30852" name="Vikings" market="Minnesota" alias="MIN" sr_id="sr:competitor:4423" yardline="34"/>
  </end_situation>
  <description>J.Love steps back to pass. Pass incomplete deep middle intended for D.Wicks. Green Bay challenged the pass completion and the play was upheld. Timeout #1 by GB.</description>
  <statistics>
    <timeout>
      <team id="a20471b4-a8d9-40c7-95ad-90cc30e46932" name="Packers" market="Green Bay" alias="GB" sr_id="sr:competitor:4420"/>
    </timeout>
    <pass attempt="1" complete="0" att_yards="0" firstdown="0" inside_20="0" goaltogo="0" incompletion_type="Poorly Thrown" blitz="0" hurry="0" knockdown="0" pocket_time="3.015" on_target_throw="0" batted_pass="0">
      <team id="a20471b4-a8d9-40c7-95ad-90cc30e46932" name="Packers" market="Green Bay" alias="GB" sr_id="sr:competitor:4420"/>
      <player id="e5094779-e94f-4052-8597-bdbee3719f6b" name="Jordan Love" jersey="10" position="QB" sr_id="sr:player:2040035"/>
    </pass>
    <receive firstdown="0" target="1" inside_20="0" goaltogo="0" dropped="0" catchable="0">
      <team id="a20471b4-a8d9-40c7-95ad-90cc30e46932" name="Packers" market="Green Bay" alias="GB" sr_id="sr:competitor:4420"/>
      <player id="ea3d1393-8c3b-4e81-a519-f636d28d692e" name="Dontayvion Wicks" jersey="13" position="WR" sr_id="sr:player:1692361"/>
    </receive>
    <defense missed_tackles="0" def_target="1" def_comp="0" blitz="0" hurry="0" knockdown="0" batted_pass="0">
      <team id="33405046-04ee-4058-a950-d606f8c30852" name="Vikings" market="Minnesota" alias="MIN" sr_id="sr:competitor:4423"/>
      <player id="bcbbd7af-5a61-41f2-bae6-1e034755e7ef" name="Kamu Grugier-Hill" jersey="54" position="LB" sr_id="sr:player:1074210"/>
    </defense>
  </statistics>
  <details>
    <detail category="pass" sequence="0">
      <description>J.Love steps back to pass.</description>
      <start_location alias="MIN" yardline="34"/>
      <end_location alias="MIN" yardline="34"/>
      <players>
        <player id="e5094779-e94f-4052-8597-bdbee3719f6b" name="Jordan Love" jersey="10" position="QB" sr_id="sr:player:2040035" role="pass"/>
      </players>
    </detail>
    <detail category="pass_incompletion" sequence="1" direction="deep middle">
      <description>Pass incomplete deep middle intended for D.Wicks.</description>
      <start_location alias="MIN" yardline="34"/>
      <end_location alias="MIN" yardline="34"/>
      <players>
        <player id="ea3d1393-8c3b-4e81-a519-f636d28d692e" name="Dontayvion Wicks" jersey="13" position="WR" sr_id="sr:player:1692361" role="receive"/>
        <player id="e5094779-e94f-4052-8597-bdbee3719f6b" name="Jordan Love" jersey="10" position="QB" sr_id="sr:player:2040035" role="pass"/>
      </players>
    </detail>
    <detail category="review" sequence="2">
      <description>Green Bay challenged the pass completion and the play was upheld.</description>
      <start_location alias="MIN" yardline="34"/>
      <end_location alias="MIN" yardline="34"/>
      <review result="upheld" type="pass completion">
        <team id="a20471b4-a8d9-40c7-95ad-90cc30e46932" name="Packers" market="Green Bay" alias="GB" sr_id="sr:competitor:4420"/>
      </review>
      <players>
      </players>
    </detail>
    <detail category="team_timeout" sequence="3">
      <description>Timeout #1 by GB.</description>
      <start_location alias="MIN" yardline="34"/>
      <end_location alias="MIN" yardline="34"/>
      <players>
      </players>
    </detail>
  </details>
</play>

{
  "type": "play",
  "id": "a7fddcb0-7e8f-11ef-a8f8-6731672f2233",
  "sequence": 1727634146815.0,
  "clock": "2:23",
  "home_points": 0,
  "away_points": 28,
  "play_type": "pass",
  "wall_clock": "2024-09-29T18:22:20+00:00",
  "description": "J.Love steps back to pass. Pass incomplete deep middle intended for D.Wicks. Green Bay challenged the pass completion and the play was upheld. Timeout #1 by GB.",
  "players_rushed": 4,
  "men_in_box": 7,
  "fake_punt": false,
  "fake_field_goal": false,
  "screen_pass": false,
  "blitz": false,
  "play_direction": "Middle",
  "left_tightends": 0,
  "right_tightends": 2,
  "hash_mark": "Right Hash",
  "pocket_location": "Middle",
  "qb_at_snap": "Shotgun",
  "huddle": "Huddle",
  "pass_route": "In",
  "play_action": false,
  "run_pass_option": false,
  "created_at": "2024-09-29T18:22:26+00:00",
  "updated_at": "2024-09-30T18:17:42+00:00",
  "start_situation": {
    "clock": "2:23",
    "down": 2,
    "yfd": 10,
    "possession": {
      "id": "a20471b4-a8d9-40c7-95ad-90cc30e46932",
      "name": "Packers",
      "market": "Green Bay",
      "alias": "GB",
      "sr_id": "sr:competitor:4420"
    },
    "location": {
      "id": "33405046-04ee-4058-a950-d606f8c30852",
      "name": "Vikings",
      "market": "Minnesota",
      "alias": "MIN",
      "sr_id": "sr:competitor:4423",
      "yardline": 34
    }
  },
  "end_situation": {
    "clock": "2:16",
    "down": 3,
    "yfd": 10,
    "possession": {
      "id": "a20471b4-a8d9-40c7-95ad-90cc30e46932",
      "name": "Packers",
      "market": "Green Bay",
      "alias": "GB",
      "sr_id": "sr:competitor:4420"
    },
    "location": {
      "id": "33405046-04ee-4058-a950-d606f8c30852",
      "name": "Vikings",
      "market": "Minnesota",
      "alias": "MIN",
      "sr_id": "sr:competitor:4423",
      "yardline": 34
    }
  },
  "statistics": [
    {
      "stat_type": "timeout",
      "team": {
        "id": "a20471b4-a8d9-40c7-95ad-90cc30e46932",
        "name": "Packers",
        "market": "Green Bay",
        "alias": "GB",
        "sr_id": "sr:competitor:4420"
      }
    },
    {
      "stat_type": "pass",
      "attempt": 1,
      "complete": 0,
      "att_yards": 0,
      "firstdown": 0,
      "inside_20": 0,
      "goaltogo": 0,
      "incompletion_type": "Poorly Thrown",
      "blitz": 0,
      "hurry": 0,
      "knockdown": 0,
      "pocket_time": 3.015,
      "on_target_throw": 0,
      "batted_pass": 0,
      "player": {
        "id": "e5094779-e94f-4052-8597-bdbee3719f6b",
        "name": "Jordan Love",
        "jersey": "10",
        "position": "QB",
        "sr_id": "sr:player:2040035"
      },
      "team": {
        "id": "a20471b4-a8d9-40c7-95ad-90cc30e46932",
        "name": "Packers",
        "market": "Green Bay",
        "alias": "GB",
        "sr_id": "sr:competitor:4420"
      }
    },
    {
      "stat_type": "receive",
      "firstdown": 0,
      "target": 1,
      "inside_20": 0,
      "goaltogo": 0,
      "dropped": 0,
      "catchable": 0,
      "player": {
        "id": "ea3d1393-8c3b-4e81-a519-f636d28d692e",
        "name": "Dontayvion Wicks",
        "jersey": "13",
        "position": "WR",
        "sr_id": "sr:player:1692361"
      },
      "team": {
        "id": "a20471b4-a8d9-40c7-95ad-90cc30e46932",
        "name": "Packers",
        "market": "Green Bay",
        "alias": "GB",
        "sr_id": "sr:competitor:4420"
      }
    },
    {
      "stat_type": "defense",
      "missed_tackles": 0,
      "def_target": 1,
      "def_comp": 0,
      "blitz": 0,
      "hurry": 0,
      "knockdown": 0,
      "batted_pass": 0,
      "player": {
        "id": "bcbbd7af-5a61-41f2-bae6-1e034755e7ef",
        "name": "Kamu Grugier-Hill",
        "jersey": "54",
        "position": "LB",
        "sr_id": "sr:player:1074210"
      },
      "team": {
        "id": "33405046-04ee-4058-a950-d606f8c30852",
        "name": "Vikings",
        "market": "Minnesota",
        "alias": "MIN",
        "sr_id": "sr:competitor:4423"
      }
    }
  ],
  "details": [
    {
      "category": "pass",
      "description": "J.Love steps back to pass.",
      "sequence": 0,
      "start_location": {
        "alias": "MIN",
        "yardline": 34
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 34
      },
      "players": [
        {
          "id": "e5094779-e94f-4052-8597-bdbee3719f6b",
          "name": "Jordan Love",
          "jersey": "10",
          "position": "QB",
          "sr_id": "sr:player:2040035",
          "role": "pass"
        }
      ]
    },
    {
      "category": "pass_incompletion",
      "description": "Pass incomplete deep middle intended for D.Wicks.",
      "sequence": 1,
      "direction": "deep middle",
      "start_location": {
        "alias": "MIN",
        "yardline": 34
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 34
      },
      "players": [
        {
          "id": "ea3d1393-8c3b-4e81-a519-f636d28d692e",
          "name": "Dontayvion Wicks",
          "jersey": "13",
          "position": "WR",
          "sr_id": "sr:player:1692361",
          "role": "receive"
        },
        {
          "id": "e5094779-e94f-4052-8597-bdbee3719f6b",
          "name": "Jordan Love",
          "jersey": "10",
          "position": "QB",
          "sr_id": "sr:player:2040035",
          "role": "pass"
        }
      ]
    },
    {
      "category": "review",
      "description": "Green Bay challenged the pass completion and the play was upheld.",
      "sequence": 2,
      "start_location": {
        "alias": "MIN",
        "yardline": 34
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 34
      },
      "review": {
        "result": "upheld",
        "type": "pass completion",
        "team": {
          "id": "a20471b4-a8d9-40c7-95ad-90cc30e46932",
          "name": "Packers",
          "market": "Green Bay",
          "alias": "GB",
          "sr_id": "sr:competitor:4420"
        }
      },
      "players": []
    },
    {
      "category": "team_timeout",
      "description": "Timeout #1 by GB.",
      "sequence": 3,
      "start_location": {
        "alias": "MIN",
        "yardline": 34
      },
      "end_location": {
        "alias": "MIN",
        "yardline": 34
      },
      "players": []
    }
  ]
},

What are the point after score types I can expect to see in the feeds?

Here are the valid score types:

extra_point
conversion
penalty

What are the play results (`details.result` or `pulse.details.result`) I can expect to see?

Below are the valid result types. These are available in Game Play-by-Play, Push Events, and Push Pulse.

accepted
backward pass
blocked
declined
downed
fair catch
fumbled
good
missed
muffed
no good
nullified touchdown
offset
overturned
pass
penalty
pushed out of bounds
ran out of bounds
returned
rush
tackled
touchback
touchdown

Transactions

What are the valid transaction_code and transaction_type values?

Here is a list of the valid transaction codes and types:

ACT - Activated
CL - Claimed
CEXP - Contract Expired
CEXT - Contract Extension
DEC - Deceased
FA - Declared Free Agency
TAG – Designated Franchise Tag
DRA - Drafted
SUS - League Suspension
ABS - Leave of Absence
NWT - Not with Team
TRAN - Other Transaction
EXE – Placed on Exempt/Commissioner’s List
IR – Placed on Injured Reserve
IRDR – Placed on Injured Reserve – Designated for Return
PUP – Placed on Physically Unable to Perform List
NON – Placed on Reserve/Non Football Injury List
RSGN - Re-Signed
RSUS - Reinstated from Suspension
REL - Released
RET - Retired
EDRA - Selected in Expansion Draft
SGN – Signed
PRA – Assigned to Practice Squad
TSUS - Team Suspension
TRD - Traded
WA – Waived
WAI – Waived – Injury

<player id="18be19e0-cc7e-11ec-8d55-87af3a9174bd" name="Stanley Berryhill" first_name="Stanley" last_name="Berryhill" position="WR" sr_id="sr:player:1261410">
    <transaction id="69bea440-6ceb-11ee-8808-8d33a3153a68" desc="WR Stanley Berryhill was reinstated from suspension." effective_date="2023-10-17" last_modified="2023-10-17T12:48:35Z" transaction_type="Reinstated from Suspension" transaction_code="RSUS" transaction_year="2023" status_before="SUS" status_after="UFA">
    </transaction>
</player>

{
    "id": "c816f5e3-7abe-4fc5-b6e0-4151017210b0",
    "name": "Jack Jones",
    "first_name": "Jack",
    "last_name": "Jones",
    "jersey": "13",
    "position": "DB",
    "sr_id": "sr:player:1209584",
    "transactions": [
        {
            "id": "fa1ea9a0-6d0d-11ee-935e-2d7aaab01588",
            "desc": "The New England Patriots placed DB Jack Jones on IRD.",
            "effective_date": "2023-10-17",
            "last_modified": "2023-10-17T16:55:53Z",
            "transaction_type": "Placed on Injury Reserve - Designated for Return",
            "transaction_code": "IRDR",
            "transaction_year": 2023,
            "status_before": "IR",
            "status_after": "IRD",
            "from_team": {
                "id": "97354895-8c77-4fd4-a860-32e62ea7382a",
                "name": "Patriots",
                "market": "New England",
                "alias": "NE",
                "sr_id": "sr:competitor:4424"
            },
            "to_team": {
                "id": "97354895-8c77-4fd4-a860-32e62ea7382a",
                "name": "Patriots",
                "market": "New England",
                "alias": "NE",
                "sr_id": "sr:competitor:4424"
            }
        }
    ]
},

What is the breadth of your transaction availability?

Our NFL transaction data goes back to 2002. All data can be accessed via the Daily Transactions endpoint.

Standings

What are the possible clinched status values I can expect to see in the Postgame Standings feed?

Here are the valid clinched status values, and their definitions:

conference – Clinched Home-Field Advantage
division_first_round_bye – Clinched First-Round Bye
division – Clinched Division Title
playoff_berth – Clinched Playoff Berth
wildcard – Clinched Wild Card
eliminated – Eliminated

<team id="386bdbf9-9eea-4869-bb9a-274b0bc66e80" name="Eagles" market="Philadelphia" alias="PHI" sr_id="sr:competitor:4428" wins="14" losses="3" ties="0" win_pct="0.824" points_for="477" points_against="344">
    <rank conference="1" division="1" clinched="conference"/>

{
    "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
    "name": "Chiefs",
    "market": "Kansas City",
    "alias": "KC",
    "sr_id": "sr:competitor:4422",
    "rank": {
        "conference": 1,
        "division": 1,
        "clinched": "conference"
    },

Officials

What are the possible official assignments I can expect to see in the feeds?

Here are the valid official assignments:

referee
umpire
headlinesman
linejudge
fieldjudge
sidejudge
backjudge
downjudge
replayofficial

<officials>
    <official full_name="Shawn Hochuli" number="83" assignment="referee"/>
    <official full_name="Tim Podraza" number="47" assignment="linejudge"/>
    <official full_name="Jason Ledet" number="72" assignment="fieldjudge"/>
    <official full_name="Rich Martinez" number="39" assignment="backjudge"/>
    <official full_name="Chad Hill" number="125" assignment="sidejudge"/>
    <official full_name="Terry Killens" number="77" assignment="umpire"/>
    <official full_name="Tyler Cerimeli" number="0" assignment="replayofficial"/>
    <official full_name="Patrick Holt" number="106" assignment="downjudge"/>
</officials>

"officials": [
    {
        "full_name": "Shawn Hochuli",
        "number": "83",
        "assignment": "referee"
    },
    {
        "full_name": "Tim Podraza",
        "number": "47",
        "assignment": "linejudge"
    },
    {
        "full_name": "Jason Ledet",
        "number": "72",
        "assignment": "fieldjudge"
    },
    {
        "full_name": "Rich Martinez",
        "number": "39",
        "assignment": "backjudge"
    },
    {
        "full_name": "Chad Hill",
        "number": "125",
        "assignment": "sidejudge"
    },
    {
        "full_name": "Terry Killens",
        "number": "77",
        "assignment": "umpire"
    },
    {
        "full_name": "Tyler Cerimeli",
        "number": "0",
        "assignment": "replayofficial"
    },
    {
        "full_name": "Patrick Holt",
        "number": "106",
        "assignment": "downjudge"
    }
],

Injuries

What are the possible injury status values I can expect to see in the feeds?

Here are the valid injury status values:

Questionable - The player has a 50/50 chance to play
Doubtful - The player is very unlikely to play
Out - The player will not play

Statistics

How are assisted sacks calculated in the feeds?

Assisted sacks are credited when two players sack the quarterback. We provide this in the Play-by-Play feed and Game Boxscore as an integer. Those sacks are rolled up into the sacks stat and can be a float.

For example, if a player had 3 ast_sacks and 2 sacks in a game his game-level sack number would be 3.5.

<player id="bc69c92c-58ff-44b2-a18b-07a08ee78dc6" name="Jonathan Greenard" jersey="52" position="DE" 
  sr_id="sr:player:2040593" tackles="3" assists="3" combined="6" sacks="2.5" sack_yards="25.0" 
  interceptions="0" passes_defended="0" forced_fumbles="0" fumble_recoveries="0" qb_hits="4" tloss="2.0" 
  tloss_yards="21.0" safeties="0" sp_tackles="0" sp_assists="0" sp_forced_fumbles="0" sp_fumble_recoveries="0" 
  sp_blocks="0" misc_tackles="0" misc_assists="0" misc_forced_fumbles="0" misc_fumble_recoveries="0" 
  def_targets="0" def_comps="0" blitzes="0" hurries="0" knockdowns="0" missed_tackles="0" batted_passes="0"/>

{
    "id": "bc69c92c-58ff-44b2-a18b-07a08ee78dc6",
    "name": "Jonathan Greenard",
    "jersey": "52",
    "position": "DE",
    "sr_id": "sr:player:2040593",
    "tackles": 3,
    "assists": 3,
    "combined": 6,
    "sacks": 2.5,
    "sack_yards": 25.0,
    "interceptions": 0,
    "passes_defended": 0,
    "forced_fumbles": 0,
    "fumble_recoveries": 0,
    "qb_hits": 4,
    "tloss": 2.0,
    "tloss_yards": 21.0,
    "safeties": 0,
    "sp_tackles": 0,
    "sp_assists": 0,
    "sp_forced_fumbles": 0,
    "sp_fumble_recoveries": 0,
    "sp_blocks": 0,
    "misc_tackles": 0,
    "misc_assists": 0,
    "misc_forced_fumbles": 0,
    "misc_fumble_recoveries": 0,
    "def_targets": 0,
    "def_comps": 0,
    "blitzes": 0,
    "hurries": 0,
    "knockdowns": 0,
    "missed_tackles": 0,
    "batted_passes": 0
},

Subjective Statistics

What are subjective stats and how are they handled?

Subjective stats are variety of data points that go beyond typical stats like yards, pass attempts, and touchdowns. Due to how the data is collected, it requires an operator to re-watch the game, thus there is a delay on when it is provided in the feeds.

These data points are delivered the following Tuesday by the end of the day (6:00 pm ET) and will show up in the existing NFL API feeds. The data is available in both XML and JSON feed formats. As the demand rises for additional data points we will continue to refine the data set collected.

Which statistics are subjective?

Here are the valid subjective statistics:

Batted Passes
Broken Tackles
Catchable Pass
Defender Blitz
Defensive Completion
Defensive Target
Dropped Pass
Fake Field Goal
Fake Punt
Hang Time
Hash Mark
Huddle
Hurry
Incompletion Type
Kneel down
Knockdown
Left Tightends
Men in Box
Missed Tackle
On Target Throws
Onside Attempt
Onside Success
Pass Route
Play Action
Play Direction
Players Rushed
Pocket Location
Pocket Time
QB at Snap
QB Blitz
QB Hurry
QB Knockdown
Right Tightends
Run Pass Option
Running Lane
Scramble
Screen Pass
TE Location
Team Blitz
Yards After Contact

Draft

How can I best integrate with your NFL Draft data?

Visit our NFL Draft integration guide for the most comprehensive info!

When can I expect NFL draftees to populate in the Prospects endpoint?

Prospects are typically added in mid to late March, after the draft order is determined by the NFL.

How is the data within the Draft feeds populated?

Sportradar’s experts seed players from our NCAA database. We use a variety of sources to generate a comprehensive list of players who expect to be drafted. The list is typically 500+ players.

When does the Draft order become available?

We set the NFL Draft order - and populate the yearly Draft Summary endpoint - after all compensatory picks have been determined.

How is an NFL prospect specified as a top prospect?

Top prospects are subjective. We use the same sources for top prospects as we do when creating the initial draft pool.

When are drafted players added to the core endpoints?

Drafted players will be available on their NFL team (Team Profile) after each completed round.

For more on how to integrate a draft day solution, see this guide.

Drives

What are the start and end reasons for a drive that I can expect to see?

Here are the end reasons for a drive:

UNKNOWN – Start/End
Touchdown – Start/End
Safety – End
Field Goal – Start/End
Missed FG – Start/End
Blocked FG – Start/End
Blocked FG, Downs – Start/End
Blocked FG, Safety – End
Punt – Start/End
Blocked Punt – Start/End
Blocked Punt, Downs – Start/End
Blocked Punt, Safety – End
Downs – Start/End
Interception – Start/End
Fumble – Start/End
Fumble, Safety - End
Missed FG – End
Muffed FG – Start/End
Muffed Punt – Start
Muffed Kickoff – Start
Kickoff – Start
Own Kickoff – Start
Onside Kick – Start
Kickoff, No Play – Start
End of Half – End
End of Game – End

Venues

What are the venue roof types I can expect to see?

Here are the valid roof types: outdoor, dome, or retractable_dome

What are the venue surfaces I can expect to see?

Here are the valid venue surfaces: turf or artifical

Scoring

When are the game scores added to the Schedule feeds?

Game and period scores are added to the feed when the game status changes to complete.

Pulse Data

What are the possible event types (`payload.pulse.event_type`) I can expect to see covered in the Push Pulse feed?

Here are the valid event types we provide:

timeout
time_adjusted
delete
timeout_over
game_suspended
game_suspended_over
coin_toss
play_start
play_over
challenge
tv_timeout
tv_timeout_over
review
review_over
players_lining_up
in_game_player_status
game_complete

Schedules

How do I pull in schedule data for future games in which teams are not yet known?

This API features a TBD team used for every entry in to-be-determined matchups. This virtual team will have its own unique ID specific to this API.

Find the TBD team in the Teams endpoint.

<team id="23ed0bf0-f058-11ee-9989-93cc4251593a" name="TBD" market="Team" alias="TBD"/>

The matchups will appear as below in the Schedule endpoints.

<series id="0f81bb4d-1d0c-4a3b-82de-507534154095" title="NBA Finals - TBD vs TBD" round="4" start_date="2024-06-06" status="scheduled">
  <games>
  <game id="342f103b-0fd7-47ac-a84d-1391e3605e96" status="time-tbd" title="Game 1" coverage="full" scheduled="2024-06-06T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
      </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="71d8d5fc-6836-43c1-85a0-61a828296a06" status="time-tbd" title="Game 2" coverage="full" scheduled="2024-06-09T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="50b170b9-37e2-47d0-b517-e56ebb960cba" status="time-tbd" title="Game 3" coverage="full" scheduled="2024-06-12T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="8e94445c-c223-4a49-a759-0b651e440b95" status="time-tbd" title="Game 4" coverage="full" scheduled="2024-06-14T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="aaa3ddb3-dd1b-459e-a686-d2bfc4408881" status="if-necessary" title="Game 5 (if necessary)" coverage="full" scheduled="2024-06-17T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="7c16f1ec-6629-4675-aaaa-2a31835862a6" status="if-necessary" title="Game 6 (if necessary)" coverage="full" scheduled="2024-06-20T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="09129676-2320-4151-976d-713ea785d97b" status="if-necessary" title="Game 7 (if necessary)" coverage="full" scheduled="2024-06-23T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
</games>
</series>

"series": [
  {
    "id": "0f81bb4d-1d0c-4a3b-82de-507534154095",
    "title": "NBA Finals - TBD vs TBD",
    "round": 4,
    "start_date": "2024-06-06",
    "status": "scheduled",
    "participants": [],
    "games": [
      {
        "id": "342f103b-0fd7-47ac-a84d-1391e3605e96",
        "status": "time-tbd",
        "title": "Game 1",
        "coverage": "full",
        "scheduled": "2024-06-06T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "71d8d5fc-6836-43c1-85a0-61a828296a06",
        "status": "time-tbd",
        "title": "Game 2",
        "coverage": "full",
        "scheduled": "2024-06-09T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "50b170b9-37e2-47d0-b517-e56ebb960cba",
        "status": "time-tbd",
        "title": "Game 3",
        "coverage": "full",
        "scheduled": "2024-06-12T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "8e94445c-c223-4a49-a759-0b651e440b95",
        "status": "time-tbd",
        "title": "Game 4",
        "coverage": "full",
        "scheduled": "2024-06-14T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "aaa3ddb3-dd1b-459e-a686-d2bfc4408881",
        "status": "if-necessary",
        "title": "Game 5 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-17T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "7c16f1ec-6629-4675-aaaa-2a31835862a6",
        "status": "if-necessary",
        "title": "Game 6 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-20T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "09129676-2320-4151-976d-713ea785d97b",
        "status": "if-necessary",
        "title": "Game 7 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-23T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      }
    ]
  },

Make note of the status attribute to determine whether the time of the game is known. A status of time-tbd indicates the game has been scheduled, but a time has yet to be announced. A status of scheduled indicates the game time is known.