Schedules
This guide explains how to pull and display schedule information.
Accessing Available Seasons (Prerequisite)
To avoid confusion and ensure you're accessing available data, refer to our Seasons feed. This resource lists all the seasons for which we have data.
For example: To ensure data availability for future seasons, such as a schedule in advance of when a season begins, first check the Seasons feed to verify that data for that specific season is already provided.
Starting with this feed can prevent unnecessary errors and streamline your data retrieval process.
Schedule Releases
Schedules in the NFL API (Preseason PRE, Regular REG, and Postseason PST) are typically released by mid-May each year.
Schedule Feeds Available
Accessing the schedule is fundamental to your integration and essential in critical scenarios. For instance, if you need to retrieve live game data, you'll first need to pull a schedule feed to obtain the game IDs for the specific games you're targeting.
You can access NFL scheduling data using the following feeds:
- Current Season Schedule – Provides schedule information for the current season, including venue and broadcast info, and scoring results by quarter.
- Current Week Schedule – Provides schedule information for the current week, including venue and broadcast info, and scoring results by quarter.
- Season Schedule – Provides complete schedule information for a given season, including venue and broadcast info, and scoring results by quarter.
- Tournament Schedule – Provides the date, time, location, and other event details for every matchup taking place in a given tournament.
- Weekly Schedule – Provides complete schedule information for a given week of the season, including venue, weather conditions, broadcast info, and scoring results by quarter.
For recommended pull intervals and timing for each schedule-related endpoint, see the Update Frequencies page to ensure you’re calling feeds at the optimal rate. Depending on the endpoint, schedule data may update hourly or in real time, so be sure to align your pulling strategy with data update intervals.
You can also use the Daily Change Log to capture schedule changes and other updates without making unnecessary calls.
Retrieving Schedules
Season Schedules
You can access an entire season schedule using the following endpoints:
- Current Season Schedule – Provides schedule information for the current season, including venue and broadcast info, and scoring results by quarter.
- Season Schedule – Provides complete schedule information for a specific season, including venue and broadcast info, and scoring results by quarter. You can use this endpoint to retrieve past, current, and upcoming season schedules.
Season Schedule Response Snippet
{
"id": "26a67dd0-dfc9-11ee-8f7c-27de425212d4",
"year": 2024,
"type": "REG",
"name": "REG",
"weeks": [
{
"id": "4a2f1a79-4890-4b5f-8789-cd678cb41009",
"sequence": 1,
"title": "1",
"games": [
{
"id": "ebb5f3ac-bb13-4dc4-ab8b-6c65623eac13",
"status": "closed",
"scheduled": "2024-09-06T00:20:00+00:00",
"attendance": 73611,
"entry_mode": "LDE",
"sr_id": "sr:match:50075555",
"game_type": "regular",
"conference_game": true,
"duration": "3:10",
"venue": {
"id": "2ec4c411-dac2-403d-b091-6b6aa4a0a914",
"name": "GEHA Field at Arrowhead Stadium",
"city": "Kansas City",
"state": "MO",
"country": "USA",
"zip": "64129",
"address": "One Arrowhead Drive",
"capacity": 76416,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:8189",
"location": {
"lat": "39.049019",
"lng": "-94.484140"
}
},
"home": {
"id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
"name": "Kansas City Chiefs",
"alias": "KC",
"game_number": 1,
"sr_id": "sr:competitor:4422"
},
"away": {
"id": "ebd87119-b331-4469-9ea6-d51fe3ce2f1c",
"name": "Baltimore Ravens",
"alias": "BAL",
"game_number": 1,
"sr_id": "sr:competitor:4413"
},
"broadcast": {
"network": "NBC"
},
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"weather": {
"condition": "Thunderstorm In Vicinity",
"humidity": 53,
"temp": 67,
"wind": {
"speed": 8,
"direction": "NE"
}
},
"scoring": {
"home_points": 27,
"away_points": 20,
"periods": [
{
"period_type": "quarter",
"id": "475e9a98-60aa-4023-8969-a717fb731d3f",
"number": 1,
"sequence": 1,
"home_points": 7,
"away_points": 7
},
{
"period_type": "quarter",
"id": "96be5c53-3ac5-4ddb-bf3e-aa94f3553c2b",
"number": 2,
"sequence": 2,
"home_points": 6,
"away_points": 3
},
{
"period_type": "quarter",
"id": "3c3e1ddc-b0b9-4d01-bf82-b3d2ef728341",
"number": 3,
"sequence": 3,
"home_points": 7,
"away_points": 0
},
{
"period_type": "quarter",
"id": "a94c2992-65ab-4545-8a67-d3476946560d",
"number": 4,
"sequence": 4,
"home_points": 7,
"away_points": 10
}
]
}
},
{
"id": "a58fcc05-e52a-4a94-b369-1f569b53521e",
"status": "closed",
"scheduled": "2024-09-07T00:15:00+00:00",
"attendance": 47236,
"entry_mode": "LDE",
"sr_id": "sr:match:49378673",
"game_type": "regular",
"conference_game": true,
"duration": "3:29",
"venue": {
"id": "c2f0d6c0-f772-11ee-a79f-5fe93d39f1bd",
"name": "Corinthians Arena",
"city": "Sao Paulo",
"country": "BRA",
"zip": "08295-005",
"address": "Av. Miguel Ignácio Curi, 111",
"capacity": 49205,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:13318",
"location": {
"lat": "-23.546100",
"lng": "-46.472440"
}
},
"home": {
"id": "386bdbf9-9eea-4869-bb9a-274b0bc66e80",
"name": "Philadelphia Eagles",
"alias": "PHI",
"game_number": 1,
"sr_id": "sr:competitor:4428"
},
"away": {
"id": "a20471b4-a8d9-40c7-95ad-90cc30e46932",
"name": "Green Bay Packers",
"alias": "GB",
"game_number": 1,
"sr_id": "sr:competitor:4420"
},
"broadcast": {
"network": "Peacock"
},
"time_zones": {
"venue": "America/Sao_Paulo",
"home": "US/Eastern",
"away": "US/Central"
},
"weather": {
"condition": "Partly Cloudy",
"humidity": 87,
"temp": 63,
"wind": {
"speed": 4,
"direction": "SE"
}
},
"scoring": {
"home_points": 34,
"away_points": 29,
"periods": [
{
"period_type": "quarter",
"id": "5d7c58e1-098f-4985-b027-b644feffde5f",
"number": 1,
"sequence": 1,
"home_points": 0,
"away_points": 6
},
{
"period_type": "quarter",
"id": "99788f96-7a86-4a6c-a3fe-043400fd64b2",
"number": 2,
"sequence": 2,
"home_points": 17,
"away_points": 13
},
{
"period_type": "quarter",
"id": "1af9f2de-911f-4d34-815f-e1bda56b9b8e",
"number": 3,
"sequence": 3,
"home_points": 14,
"away_points": 7
},
{
"period_type": "quarter",
"id": "289f8070-bfb0-47f3-ab5d-07d175b60086",
"number": 4,
"sequence": 4,
"home_points": 3,
"away_points": 3
}
]
}
},
{
"id": "141b9066-8c4b-4261-b135-fd043301b2dd",
"status": "closed",
"scheduled": "2024-09-08T17:00:00+00:00",
"attendance": 70007,
"entry_mode": "LDE",
"sr_id": "sr:match:50128241",
"game_type": "regular",
"conference_game": true,
"duration": "3:10",
"venue": {
"id": "3c85d89a-ec66-4983-acd5-1381d6c8673a",
"name": "Caesars Superdome",
"city": "New Orleans",
"state": "LA",
"country": "USA",
"zip": "70112",
"address": "1500 Sugar Bowl Drive",
"capacity": 73208,
"surface": "artificial",
"roof_type": "dome",
"sr_id": "sr:venue:8195",
"location": {
"lat": "29.950928",
"lng": "-90.080876"
}
},
"home": {
"id": "0d855753-ea21-4953-89f9-0e20aff9eb73",
"name": "New Orleans Saints",
"alias": "NO",
"game_number": 1,
"sr_id": "sr:competitor:4425"
},
"away": {
"id": "f14bf5cc-9a82-4a38-bc15-d39f75ed5314",
"name": "Carolina Panthers",
"alias": "CAR",
"game_number": 1,
"sr_id": "sr:competitor:4415"
},
"broadcast": {
"network": "FOX"
},
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"weather": {
"condition": "Controlled Climate",
"humidity": 62,
"temp": 77,
"wind": {
"speed": 13,
"direction": "ENE"
}
},
"scoring": {
"home_points": 47,
"away_points": 10,
"periods": [
{
"period_type": "quarter",
"id": "6ba08e22-9dd3-46ef-a58a-be6dfe947dae",
"number": 1,
"sequence": 1,
"home_points": 17,
"away_points": 0
},
{
"period_type": "quarter",
"id": "c5f9799c-1c6a-4f53-a751-c625ffca9b02",
"number": 2,
"sequence": 2,
"home_points": 13,
"away_points": 3
},
{
"period_type": "quarter",
"id": "21e21380-e75a-450a-bc6d-cf10c0af7938",
"number": 3,
"sequence": 3,
"home_points": 7,
"away_points": 7
},
{
"period_type": "quarter",
"id": "057b4690-b192-4b69-bc2c-6bacb3377aee",
"number": 4,
"sequence": 4,
"home_points": 10,
"away_points": 0
}
]
}
},
<season xmlns="http://feed.elasticstats.com/schema/football/schedule-v7.0.xsd" id="26a67dd0-dfc9-11ee-8f7c-27de425212d4" year="2024" type="REG" name="REG">
<week id="4a2f1a79-4890-4b5f-8789-cd678cb41009" sequence="1" title="1">
<game id="ebb5f3ac-bb13-4dc4-ab8b-6c65623eac13" status="closed" scheduled="2024-09-06T00:20:00+00:00" attendance="73611" entry_mode="LDE" sr_id="sr:match:50075555" game_type="regular" conference_game="true" duration="3:10">
<venue id="2ec4c411-dac2-403d-b091-6b6aa4a0a914" name="GEHA Field at Arrowhead Stadium" city="Kansas City" state="MO" country="USA" zip="64129" address="One Arrowhead Drive" capacity="76416" surface="turf" roof_type="outdoor" sr_id="sr:venue:8189">
<location lat="39.049019" lng="-94.484140"/>
</venue>
<home id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Kansas City Chiefs" alias="KC" game_number="1" sr_id="sr:competitor:4422"/>
<away id="ebd87119-b331-4469-9ea6-d51fe3ce2f1c" name="Baltimore Ravens" alias="BAL" game_number="1" sr_id="sr:competitor:4413"/>
<broadcast network="NBC"/>
<time_zones venue="US/Central" home="US/Central" away="US/Eastern"/>
<weather condition="Thunderstorm In Vicinity" humidity="53" temp="67">
<wind speed="8" direction="NE"/>
</weather>
<scoring home_points="27" away_points="20">
<quarter id="475e9a98-60aa-4023-8969-a717fb731d3f" number="1" sequence="1" home_points="7" away_points="7"/>
<quarter id="96be5c53-3ac5-4ddb-bf3e-aa94f3553c2b" number="2" sequence="2" home_points="6" away_points="3"/>
<quarter id="3c3e1ddc-b0b9-4d01-bf82-b3d2ef728341" number="3" sequence="3" home_points="7" away_points="0"/>
<quarter id="a94c2992-65ab-4545-8a67-d3476946560d" number="4" sequence="4" home_points="7" away_points="10"/>
</scoring>
</game>
<game id="a58fcc05-e52a-4a94-b369-1f569b53521e" status="closed" scheduled="2024-09-07T00:15:00+00:00" attendance="47236" entry_mode="LDE" sr_id="sr:match:49378673" game_type="regular" conference_game="true" duration="3:29">
<venue id="c2f0d6c0-f772-11ee-a79f-5fe93d39f1bd" name="Corinthians Arena" city="Sao Paulo" country="BRA" zip="08295-005" address="Av. Miguel Ignácio Curi, 111" capacity="49205" surface="turf" roof_type="outdoor" sr_id="sr:venue:13318">
<location lat="-23.546100" lng="-46.472440"/>
</venue>
<home id="386bdbf9-9eea-4869-bb9a-274b0bc66e80" name="Philadelphia Eagles" alias="PHI" game_number="1" sr_id="sr:competitor:4428"/>
<away id="a20471b4-a8d9-40c7-95ad-90cc30e46932" name="Green Bay Packers" alias="GB" game_number="1" sr_id="sr:competitor:4420"/>
<broadcast network="Peacock"/>
<time_zones venue="America/Sao_Paulo" home="US/Eastern" away="US/Central"/>
<weather condition="Partly Cloudy" humidity="87" temp="63">
<wind speed="4" direction="SE"/>
</weather>
<scoring home_points="34" away_points="29">
<quarter id="5d7c58e1-098f-4985-b027-b644feffde5f" number="1" sequence="1" home_points="0" away_points="6"/>
<quarter id="99788f96-7a86-4a6c-a3fe-043400fd64b2" number="2" sequence="2" home_points="17" away_points="13"/>
<quarter id="1af9f2de-911f-4d34-815f-e1bda56b9b8e" number="3" sequence="3" home_points="14" away_points="7"/>
<quarter id="289f8070-bfb0-47f3-ab5d-07d175b60086" number="4" sequence="4" home_points="3" away_points="3"/>
</scoring>
</game>
<game id="141b9066-8c4b-4261-b135-fd043301b2dd" status="closed" scheduled="2024-09-08T17:00:00+00:00" attendance="70007" entry_mode="LDE" sr_id="sr:match:50128241" game_type="regular" conference_game="true" duration="3:10">
<venue id="3c85d89a-ec66-4983-acd5-1381d6c8673a" name="Caesars Superdome" city="New Orleans" state="LA" country="USA" zip="70112" address="1500 Sugar Bowl Drive" capacity="73208" surface="artificial" roof_type="dome" sr_id="sr:venue:8195">
<location lat="29.950928" lng="-90.080876"/>
</venue>
<home id="0d855753-ea21-4953-89f9-0e20aff9eb73" name="New Orleans Saints" alias="NO" game_number="1" sr_id="sr:competitor:4425"/>
<away id="f14bf5cc-9a82-4a38-bc15-d39f75ed5314" name="Carolina Panthers" alias="CAR" game_number="1" sr_id="sr:competitor:4415"/>
<broadcast network="FOX"/>
<time_zones venue="US/Central" home="US/Central" away="US/Eastern"/>
<weather condition="Controlled Climate" humidity="62" temp="77">
<wind speed="13" direction="ENE"/>
</weather>
<scoring home_points="47" away_points="10">
<quarter id="6ba08e22-9dd3-46ef-a58a-be6dfe947dae" number="1" sequence="1" home_points="17" away_points="0"/>
<quarter id="c5f9799c-1c6a-4f53-a751-c625ffca9b02" number="2" sequence="2" home_points="13" away_points="3"/>
<quarter id="21e21380-e75a-450a-bc6d-cf10c0af7938" number="3" sequence="3" home_points="7" away_points="7"/>
<quarter id="057b4690-b192-4b69-bc2c-6bacb3377aee" number="4" sequence="4" home_points="10" away_points="0"/>
</scoring>
</game>
When you query the Season Schedule endpoint, you’ll get the full schedule broken down by weeks and games. Each game object includes metadata such as status, scheduled time, venue details (with location, capacity, and surface), home and away teams, broadcast network, and time zones. You’ll also see weather conditions, attendance, and scoring by quarter. Use this feed to build weekly or season-long schedule views, track game results, or enrich your applications with venue, broadcast, and scoring context.
Weekly Schedules
If you want to pull schedule data one week at a time, you can use the Weekly Schedule endpoints. This is useful if you want to reduce payload size compared to retrieving the entire season schedule.
- Current Week Schedule – Provides schedule information for the current week, including venue and broadcast info, and scoring results by quarter.
- Weekly Schedule – Provides complete schedule information for a given week of the season, including venue, weather conditions, broadcast info, and scoring results by quarter. You can use this endpoint to retrieve past, current, and upcoming weekly schedules for any available season.
Weekly Schedule Response Snippet
{
"id": "26a67dd0-dfc9-11ee-8f7c-27de425212d4",
"year": 2024,
"type": "REG",
"name": "REG",
"week": {
"id": "1c5691ce-be42-4b02-8f17-a68700c49cea",
"sequence": 2,
"title": "2",
"games": [
{
"id": "e85b2f3d-c9ca-4c8b-961c-d9a78b22954d",
"status": "closed",
"scheduled": "2024-09-13T00:15:00+00:00",
"attendance": 65601,
"entry_mode": "LDE",
"sr_id": "sr:match:50103629",
"game_type": "regular",
"conference_game": true,
"title": "Thursday Night Football",
"duration": "2:55",
"venue": {
"id": "50a5c833-1570-4c38-abc7-7914cf87dbde",
"name": "Hard Rock Stadium",
"city": "Miami Gardens",
"state": "FL",
"country": "USA",
"zip": "33056",
"address": "2269 Northwest 199th Street",
"capacity": 65326,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:21306",
"location": {
"lat": "25.958025",
"lng": "-80.238724"
}
},
"home": {
"id": "4809ecb0-abd3-451d-9c4a-92a90b83ca06",
"name": "Miami Dolphins",
"alias": "MIA",
"game_number": 2,
"sr_id": "sr:competitor:4287"
},
"away": {
"id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724",
"name": "Buffalo Bills",
"alias": "BUF",
"game_number": 2,
"sr_id": "sr:competitor:4376"
},
"broadcast": {
"network": "Amazon Prime Video"
},
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Eastern"
},
"weather": {
"condition": "Partly Cloudy",
"humidity": 79,
"temp": 86,
"wind": {
"speed": 3,
"direction": "S"
}
},
"scoring": {
"home_points": 10,
"away_points": 31,
"periods": [
{
"period_type": "quarter",
"id": "16f9ac6e-a501-485d-b953-ca7fb5058960",
"number": 1,
"sequence": 1,
"home_points": 7,
"away_points": 7
},
{
"period_type": "quarter",
"id": "9b7de53c-bf67-4860-994f-dc24e7542919",
"number": 2,
"sequence": 2,
"home_points": 3,
"away_points": 17
},
{
"period_type": "quarter",
"id": "a19672a9-9233-492b-a2ed-c245e127a6af",
"number": 3,
"sequence": 3,
"home_points": 0,
"away_points": 7
},
{
"period_type": "quarter",
"id": "f66f246a-a3d5-42cc-8255-b346639ecec1",
"number": 4,
"sequence": 4,
"home_points": 0,
"away_points": 0
}
]
}
},
{
"id": "2b28f3dd-6bf4-47f6-85fe-cdc0e1855c28",
"status": "closed",
"scheduled": "2024-09-15T17:00:00+00:00",
"attendance": 93691,
"entry_mode": "LDE",
"sr_id": "sr:match:50128257",
"game_type": "regular",
"conference_game": true,
"duration": "2:54",
"venue": {
"id": "1e84213a-ff1f-4c9d-a003-8ee782b25a40",
"name": "AT&T Stadium",
"city": "Arlington",
"state": "TX",
"country": "USA",
"zip": "76011",
"address": "One Legends Way",
"capacity": 80000,
"surface": "artificial",
"roof_type": "retractable_dome",
"sr_id": "sr:venue:6650",
"location": {
"lat": "32.747778",
"lng": "-97.092778"
}
},
"home": {
"id": "e627eec7-bbae-4fa4-8e73-8e1d6bc5c060",
"name": "Dallas Cowboys",
"alias": "DAL",
"game_number": 2,
"sr_id": "sr:competitor:4392"
},
"away": {
"id": "0d855753-ea21-4953-89f9-0e20aff9eb73",
"name": "New Orleans Saints",
"alias": "NO",
"game_number": 2,
"sr_id": "sr:competitor:4425"
},
"broadcast": {
"network": "FOX"
},
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Central"
},
"weather": {
"condition": "Controlled Climate",
"humidity": 54,
"temp": 86,
"wind": {
"speed": 7,
"direction": "E"
}
},
"scoring": {
"home_points": 19,
"away_points": 44,
"periods": [
{
"period_type": "quarter",
"id": "49fac82d-9f33-47f8-8314-d834938e1064",
"number": 1,
"sequence": 1,
"home_points": 3,
"away_points": 14
},
{
"period_type": "quarter",
"id": "47e8afe4-b965-48e5-b5d0-a4dc63d63057",
"number": 2,
"sequence": 2,
"home_points": 13,
"away_points": 21
},
{
"period_type": "quarter",
"id": "8eea9e09-9063-4cd6-9568-889c440c7bc6",
"number": 3,
"sequence": 3,
"home_points": 3,
"away_points": 6
},
{
"period_type": "quarter",
"id": "500211ae-8aff-4846-810e-82e4386dc8f5",
"number": 4,
"sequence": 4,
"home_points": 0,
"away_points": 3
}
]
}
},
{
"id": "35e4b92e-58ec-4042-bca5-16433b0f8135",
"status": "closed",
"scheduled": "2024-09-15T17:00:00+00:00",
"attendance": 70762,
"entry_mode": "LDE",
"sr_id": "sr:match:50128253",
"game_type": "regular",
"conference_game": true,
"duration": "3:22",
"venue": {
"id": "d54faae0-0314-484f-8604-9d8dd08e1149",
"name": "M&T Bank Stadium",
"city": "Baltimore",
"state": "MD",
"country": "USA",
"zip": "21230",
"address": "1101 Russell Street",
"capacity": 71008,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:8169",
"location": {
"lat": "39.277995",
"lng": "-76.622592"
}
},
"home": {
"id": "ebd87119-b331-4469-9ea6-d51fe3ce2f1c",
"name": "Baltimore Ravens",
"alias": "BAL",
"game_number": 2,
"sr_id": "sr:competitor:4413"
},
"away": {
"id": "7d4fcc64-9cb5-4d1b-8e75-8a906d1e1576",
"name": "Las Vegas Raiders",
"alias": "LV",
"game_number": 2,
"sr_id": "sr:competitor:4390"
},
"broadcast": {
"network": "CBS"
},
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Pacific"
},
"weather": {
"condition": "Partly cloudy",
"humidity": 64,
"temp": 76,
"wind": {
"speed": 10,
"direction": "E"
}
},
"scoring": {
"home_points": 23,
"away_points": 26,
"periods": [
{
"period_type": "quarter",
"id": "8b6a7e81-d3cf-409a-a3ce-be14c5058284",
"number": 1,
"sequence": 1,
"home_points": 3,
"away_points": 0
},
{
"period_type": "quarter",
"id": "d1a2ccc6-df29-4502-8913-2dc13a8ff40a",
"number": 2,
"sequence": 2,
"home_points": 6,
"away_points": 6
},
{
"period_type": "quarter",
"id": "48939df6-9166-439b-a4fa-de4eed7c8c0e",
"number": 3,
"sequence": 3,
"home_points": 7,
"away_points": 7
},
{
"period_type": "quarter",
"id": "b7b46adb-2eb3-4d3d-8aac-286ac798932f",
"number": 4,
"sequence": 4,
"home_points": 7,
"away_points": 13
}
]
}
}
]
}
}
<season xmlns="http://feed.elasticstats.com/schema/football/schedule-v7.0.xsd" id="26a67dd0-dfc9-11ee-8f7c-27de425212d4" year="2024" type="REG" name="REG">
<week id="1c5691ce-be42-4b02-8f17-a68700c49cea" sequence="2" title="2">
<game id="e85b2f3d-c9ca-4c8b-961c-d9a78b22954d" status="closed" scheduled="2024-09-13T00:15:00+00:00" attendance="65601" entry_mode="LDE" sr_id="sr:match:50103629" game_type="regular" conference_game="true" title="Thursday Night Football" duration="2:55">
<venue id="50a5c833-1570-4c38-abc7-7914cf87dbde" name="Hard Rock Stadium" city="Miami Gardens" state="FL" country="USA" zip="33056" address="2269 Northwest 199th Street" capacity="65326" surface="turf" roof_type="outdoor" sr_id="sr:venue:21306">
<location lat="25.958025" lng="-80.238724"/>
</venue>
<home id="4809ecb0-abd3-451d-9c4a-92a90b83ca06" name="Miami Dolphins" alias="MIA" game_number="2" sr_id="sr:competitor:4287"/>
<away id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Buffalo Bills" alias="BUF" game_number="2" sr_id="sr:competitor:4376"/>
<broadcast network="Amazon Prime Video"/>
<time_zones venue="US/Eastern" home="US/Eastern" away="US/Eastern"/>
<weather condition="Partly Cloudy" humidity="79" temp="86">
<wind speed="3" direction="S"/>
</weather>
<scoring home_points="10" away_points="31">
<quarter id="16f9ac6e-a501-485d-b953-ca7fb5058960" number="1" sequence="1" home_points="7" away_points="7"/>
<quarter id="9b7de53c-bf67-4860-994f-dc24e7542919" number="2" sequence="2" home_points="3" away_points="17"/>
<quarter id="a19672a9-9233-492b-a2ed-c245e127a6af" number="3" sequence="3" home_points="0" away_points="7"/>
<quarter id="f66f246a-a3d5-42cc-8255-b346639ecec1" number="4" sequence="4" home_points="0" away_points="0"/>
</scoring>
</game>
<game id="2b28f3dd-6bf4-47f6-85fe-cdc0e1855c28" status="closed" scheduled="2024-09-15T17:00:00+00:00" attendance="93691" entry_mode="LDE" sr_id="sr:match:50128257" game_type="regular" conference_game="true" duration="2:54">
<venue id="1e84213a-ff1f-4c9d-a003-8ee782b25a40" name="AT&T Stadium" city="Arlington" state="TX" country="USA" zip="76011" address="One Legends Way" capacity="80000" surface="artificial" roof_type="retractable_dome" sr_id="sr:venue:6650">
<location lat="32.747778" lng="-97.092778"/>
</venue>
<home id="e627eec7-bbae-4fa4-8e73-8e1d6bc5c060" name="Dallas Cowboys" alias="DAL" game_number="2" sr_id="sr:competitor:4392"/>
<away id="0d855753-ea21-4953-89f9-0e20aff9eb73" name="New Orleans Saints" alias="NO" game_number="2" sr_id="sr:competitor:4425"/>
<broadcast network="FOX"/>
<time_zones venue="US/Central" home="US/Central" away="US/Central"/>
<weather condition="Controlled Climate" humidity="54" temp="86">
<wind speed="7" direction="E"/>
</weather>
<scoring home_points="19" away_points="44">
<quarter id="49fac82d-9f33-47f8-8314-d834938e1064" number="1" sequence="1" home_points="3" away_points="14"/>
<quarter id="47e8afe4-b965-48e5-b5d0-a4dc63d63057" number="2" sequence="2" home_points="13" away_points="21"/>
<quarter id="8eea9e09-9063-4cd6-9568-889c440c7bc6" number="3" sequence="3" home_points="3" away_points="6"/>
<quarter id="500211ae-8aff-4846-810e-82e4386dc8f5" number="4" sequence="4" home_points="0" away_points="3"/>
</scoring>
</game>
<game id="35e4b92e-58ec-4042-bca5-16433b0f8135" status="closed" scheduled="2024-09-15T17:00:00+00:00" attendance="70762" entry_mode="LDE" sr_id="sr:match:50128253" game_type="regular" conference_game="true" duration="3:22">
<venue id="d54faae0-0314-484f-8604-9d8dd08e1149" name="M&T Bank Stadium" city="Baltimore" state="MD" country="USA" zip="21230" address="1101 Russell Street" capacity="71008" surface="turf" roof_type="outdoor" sr_id="sr:venue:8169">
<location lat="39.277995" lng="-76.622592"/>
</venue>
<home id="ebd87119-b331-4469-9ea6-d51fe3ce2f1c" name="Baltimore Ravens" alias="BAL" game_number="2" sr_id="sr:competitor:4413"/>
<away id="7d4fcc64-9cb5-4d1b-8e75-8a906d1e1576" name="Las Vegas Raiders" alias="LV" game_number="2" sr_id="sr:competitor:4390"/>
<broadcast network="CBS"/>
<time_zones venue="US/Eastern" home="US/Eastern" away="US/Pacific"/>
<weather condition="Partly cloudy" humidity="64" temp="76">
<wind speed="10" direction="E"/>
</weather>
<scoring home_points="23" away_points="26">
<quarter id="8b6a7e81-d3cf-409a-a3ce-be14c5058284" number="1" sequence="1" home_points="3" away_points="0"/>
<quarter id="d1a2ccc6-df29-4502-8913-2dc13a8ff40a" number="2" sequence="2" home_points="6" away_points="6"/>
<quarter id="48939df6-9166-439b-a4fa-de4eed7c8c0e" number="3" sequence="3" home_points="7" away_points="7"/>
<quarter id="b7b46adb-2eb3-4d3d-8aac-286ac798932f" number="4" sequence="4" home_points="7" away_points="13"/>
</scoring>
</game>
When you query the Weekly Schedule endpoint, you’ll get schedule data for one specific week of the season. Each game object includes status, scheduled time, venue details (with location, capacity, and surface), home and away teams, broadcast network, time zones, weather, and scoring by quarter. You can use this feed to display weekly matchups, highlight results, or keep your app focused on just the games that matter for the current week, without pulling the entire season schedule.
The following is an example of how you can display a weekly schedules on your platform, showcasing key details such as team names and quarterly and final scores for past games.
To access team logos and player headshots, use the Images API.
Tournament Schedules
The Tournament Schedule endpoint provides the date, time, location, and other event details for every matchup taking place in a given tournament. For more details on tracking tournaments and building brackets, see the Playoffs integration scenario.
Using the Daily Change Log (Schedule Updates)
The NFL Daily Change Log lists IDs and timestamps for schedules, teams, players, results, and game stats that were modified on a given date. This endpoint helps you track schedule changes and other updates efficiently without exhausting API call limits.
Use the returned player, team, or game IDs to pull the relevant feeds and retrieve the full update details. See our Daily Change Log guide for more details.
Updated 4 days ago