Skip to content

Instantly share code, notes, and snippets.

@nntrn

nntrn/espn-api-list.md

Last active July 29, 2025 03:54
Show Gist options
  • Save nntrn/ee26cb2a0716de0947a0a4e9a157bc1c to your computer and use it in GitHub Desktop.
Save nntrn/ee26cb2a0716de0947a0a4e9a157bc1c to your computer and use it in GitHub Desktop.
Download ZIP
List of nfl api endpoints from espn
Raw
espn-api-list.md

List of NFL API Endpoints

This page is limited to NFL endpoints but can be refashioned for other sports leagues (i.e. /sports/football/leagues/nfl/ => /sports/baseball/leagues/mlb/)

ATHLETES

/apis/common/v3/sports/football/nfl/athletes/:athlete_id [View]

{
  "athlete": {
    "id": "14876",
    "uid": "s:20~l:28~a:14876",
    "guid": "2d6af5dcb3d3e2d4cf7227d4a8eb93cd",
    "type": "football",
    "firstName": "Ryan",
    "lastName": "Tannehill",
    "displayName": "Ryan Tannehill",
    "fullName": "Ryan Tannehill",
    "debutYear": 2012,
    "jersey": "17",
    "links": [
      {
        "language": "en",

/v2/sports/football/leagues/nfl/athletes [View]

{
  "count": 16438,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 658,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/4246273"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/4246281"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/4246289"
    },

/v2/sports/football/leagues/nfl/athletes/:athlete_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/12483",
  "id": "12483",
  "uid": "s:20~l:28~a:12483",
  "guid": "20c41c33a33f6dc27e1f0771e39ce49a",
  "type": "football",
  "alternateIds": {
    "sdr": "2219510"
  },
  "firstName": "Matthew",
  "lastName": "Stafford",
  "fullName": "Matthew Stafford",
  "displayName": "Matthew Stafford",
  "shortName": "M. Stafford",
  "weight": 220,

Bio

/athletes/bio

/apis/common/v3/sports/football/nfl/athletes/:athlete_id/bio [View]

{
  "teamHistory": [
    {
      "id": "10",
      "uid": "s:20~l:28~t:10",
      "slug": "tennessee-titans",
      "displayName": "Tennessee Titans",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/ten.png",
      "seasons": "2019-CURRENT",
      "links": [
        {
          "language": "en",
          "rel": [
            "clubhouse",
            "desktop",

Eventlog

/athletes/eventlog

/v2/sports/football/leagues/nfl/seasons/:year/athletes/:athlete_id/eventlog [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/eventlog",
  "teams": {
    "10": {
      "team": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/10"
      },
      "id": "10"
    }
  },
  "events": {
    "count": 14,
    "pageIndex": 1,
    "pageSize": 25,
    "pageCount": 1,

Gamelog

/athletes/gamelog

/apis/common/v3/sports/football/nfl/athletes/:athlete_id/gamelog [View]

{
  "categories": [
    {
      "name": "passing",
      "displayName": "Passing",
      "count": 11
    },
    {
      "name": "rushing",
      "displayName": "Rushing",
      "count": 5
    }
  ],
  "filters": [
    {

Notes

/athletes/notes

/v2/sports/football/leagues/nfl/seasons/:year/athletes/:athlete_id/notes [View]

{
  "count": 1,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "id": "498444",
      "type": "news",
      "date": "2021-12-17T20:14Z",
      "headline": "Stafford and the Rams aren't in line to play the Seahawks on Sunday, with the NFL expected to reschedule the game for Tuesday at 7 p.m. ET, pending official confirmation, Adam Schefter of ESPN reports.",
      "text": "Due to ongoing COVID-19-related issues within the Rams organization, the NFL is hopeful that by delaying the game two days, Los Angeles will be able to restore enough players from the reserve/COVID-19 list to alleviate depth concerns on the roster. After Tuesday's game, the Rams will face a quick turnaround for Week 16 with a Sunday game in Minnesota on Dec. 26.",
      "source": "RotoWire"
    }
  ]
}

Projections

/athletes/projections

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/athletes/:athlete_id/projections [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0",
  "season": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021"
  },
  "athlete": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876"
  },
  "splits": {
    "id": "0",
    "name": "All Splits",
    "abbreviation": "Any",
    "type": "total",
    "categories": [
      {

Splits

/athletes/splits

/apis/common/v3/sports/football/nfl/athletes/:athlete_id/splits [View]

{
  "filters": [
    {
      "displayName": "League",
      "name": "league",
      "value": "nfl",
      "options": [
        {
          "value": "college-football",
          "displayValue": "NCAAF"
        },
        {
          "value": "nfl",
          "displayValue": "NFL"
        }

Statistics

/athletes/statistics

/v2/sports/football/leagues/nfl/athletes/:athlete_id/statistics/0 [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/12483/statistics/0",
  "athlete": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/12483"
  },
  "splits": {
    "id": "0",
    "name": "All Splits",
    "abbreviation": "Any",
    "categories": [
      {
        "name": "general",
        "displayName": "General",
        "shortDisplayName": "General",
        "abbreviation": "gen",

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/athletes/:athlete_id/statistics [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0",
  "season": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021"
  },
  "athlete": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876"
  },
  "splits": {
    "id": "0",
    "name": "All Splits",
    "abbreviation": "Any",
    "type": "total",
    "categories": [
      {

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/athletes/:athlete_id/statistics/0 [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/12483/statistics/0",
  "season": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021"
  },
  "athlete": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/12483"
  },
  "splits": {
    "id": "0",
    "name": "All Splits",
    "abbreviation": "Any",
    "type": "total",
    "categories": [
      {

Statisticslog

/athletes/statisticslog

/v2/sports/football/leagues/nfl/athletes/:athlete_id/statisticslog [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog",
  "entries": [
    {
      "season": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021"
      },
      "statistics": [
        {
          "type": "total",
          "statistics": {
            "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0"
          }
        },
        {

Stats

/athletes/stats

/apis/common/v3/sports/football/nfl/athletes/:athlete_id/stats [View]

{
  "filters": [
    {
      "displayName": "League",
      "name": "league",
      "value": "nfl",
      "options": [
        {
          "value": "college-football",
          "displayValue": "NCAAF"
        },
        {
          "value": "nfl",
          "displayValue": "NFL"
        }

CALENDAR

/v2/sports/football/leagues/nfl/calendar [View]

{
  "count": 4,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist"
    }
  ]
}

Blacklist

/calendar/blacklist

/v2/sports/football/leagues/nfl/calendar/blacklist [View]

{
  "type": "list",
  "startDate": "2021-07-17T07:00Z",
  "endDate": "2022-02-16T07:59Z",
  "eventDate": {
    "type": "blacklist",
    "dates": [
      "2021-07-17T07:00Z",
      "2021-07-18T07:00Z",
      "2021-07-19T07:00Z",
      "2021-07-20T07:00Z",
      "2021-07-21T07:00Z",
      "2021-07-22T07:00Z",
      "2021-07-23T07:00Z",

Whitelist

/calendar/whitelist

/v2/sports/football/leagues/nfl/calendar/whitelist [View]

{
  "type": "list",
  "startDate": "2021-07-17T07:00Z",
  "endDate": "2022-02-16T07:59Z",
  "eventDate": {
    "type": "whitelist",
    "dates": [
      "2021-08-05T07:00Z",
      "2021-08-12T07:00Z",
      "2021-08-13T07:00Z",
      "2021-08-14T07:00Z",
      "2021-08-15T07:00Z",
      "2021-08-19T07:00Z",
      "2021-08-20T07:00Z",

Drives

/competitions/drives

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id/drives/:drive_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/drives/4012490631",
  "id": "4012490631",
  "description": "16 plays, 75 yards, 9:18",
  "sequenceNumber": "1",
  "team": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23"
  },
  "endTeam": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23"
  },
  "start": {
    "period": {
      "type": "quarter",
      "number": 1

Odds

/competitions/odds

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id/odds [View]

{
  "count": 11,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/odds/43",
      "provider": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/43",
        "id": "43",
        "name": "Caesars Sportsbook (Pennsylvania)",
        "priority": 1
      },
      "overUnder": 49.5,

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id/odds/:provider_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003",
  "provider": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003",
    "id": "1003",
    "name": "numberfire",
    "priority": 0
  },
  "details": "ATL -3.5",
  "overUnder": 48.5,
  "spread": -3.5,
  "overOdds": 45.31,
  "underOdds": 54.69,
  "awayTeamOdds": {
    "averageScore": 20.62,

Plays

/competitions/plays

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id/plays/:play_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631",
  "id": "4012490631",
  "sequenceNumber": "100",
  "type": {
    "id": "70",
    "text": "Coin Toss"
  },
  "text": "GAME",
  "shortText": "PIT Win Toss, Elect to Receive",
  "alternativeText": "GAME",
  "shortAlternativeText": "PIT Win Toss, Elect to Receive",
  "awayScore": 0,
  "homeScore": 0,
  "period": {

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id/plays [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?source=2&lang=en&region=us",
  "count": 167,
  "pageIndex": 1,
  "pageSize": 100,
  "pageCount": 2,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays/4012201811",
      "id": "4012201811",
      "sequenceNumber": "100",
      "type": {
        "id": "70",
        "text": "Coin Toss"
      },

Probabilities

/competitions/probabilities

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id/probabilities/:probabilities_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631",
  "competition": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315"
  },
  "play": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/plays/4012490631"
  },
  "homeTeam": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1"
  },
  "awayTeam": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21"
  },
  "tiePercentage": 0,

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id/probabilities [View]

{
  "count": 166,
  "pageIndex": 1,
  "pageSize": 100,
  "pageCount": 2,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities/4012201811",
      "competition": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181"
      },
      "play": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays/4012201811"
      },
      "homeTeam": {

Roster

/competitors/roster

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id/competitors/:competitors_id/roster [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster",
  "entries": [
    {
      "playerId": 13979,
      "period": 0,
      "active": false,
      "starter": true,
      "forPlayerId": 0,
      "jersey": "99",
      "valid": true,
      "athlete": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/athletes/13979"
      },
      "position": {

Athletes

/draft/athletes

/v2/sports/football/leagues/nfl/seasons/:year/draft/athletes [View]

{
  "count": 366,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 15,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104734"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104760"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104737"
    },

Rounds

/draft/rounds

/v2/sports/football/leagues/nfl/seasons/:year/draft/rounds [View]

{
  "count": 7,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "number": 1,
      "displayName": "1st Round",
      "shortDisplayName": "1st",
      "picks": [
        {
          "status": {
            "id": 3,
            "name": "SELECTION_MADE",

Status

/draft/status

/v2/sports/football/leagues/nfl/seasons/:year/draft/status [View]

{
  "round": 7,
  "type": {
    "id": 3,
    "name": "COMPLETED",
    "state": "post",
    "description": "Completed"
  }
}

EVENTS

/v2/sports/football/leagues/nfl/events [View]

{
  "$meta": {
    "parameters": {
      "week": [
        "15"
      ],
      "season": [
        "2021"
      ],
      "seasontypes": [
        "2"
      ]
    }
  },
  "count": 16,

/v2/sports/football/leagues/nfl/events/:event_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315",
  "id": "401326315",
  "uid": "s:20~l:28~e:401326315",
  "date": "2021-09-12T17:00Z",
  "name": "Philadelphia Eagles at Atlanta Falcons",
  "shortName": "PHI @ ATL",
  "season": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021"
  },
  "seasonType": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2"
  },
  "week": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1"

Competitions

/events/competitions

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id [View]

{
  "id": "401326315",
  "guid": "b64e5dc5-c943-33e6-a6c9-44008b28b11a",
  "uid": "s:20~l:28~e:401326315~c:401326315",
  "date": "2021-09-12T17:00Z",
  "attendance": 68633,
  "type": {
    "id": "1",
    "text": "Standard",
    "abbreviation": "STD",
    "slug": "standard",
    "type": "standard"
  },
  "necessary": false,

FRANCHISES

/v2/sports/football/leagues/nfl/franchises [View]

{
  "count": 32,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 2,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/2"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/3"
    },

/v2/sports/football/leagues/nfl/franchises/:franchise_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1",
  "id": "1",
  "uid": "s:20~l:28~f:1",
  "slug": "atlanta-falcons",
  "location": "Atlanta",
  "name": "Falcons",
  "nickname": "Atlanta",
  "abbreviation": "ATL",
  "displayName": "Atlanta Falcons",
  "shortDisplayName": "Falcons",
  "color": "000000",
  "isActive": true,
  "logos": [
    {

Standings

/groups/standings

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/groups/:group_id/standings [View]

{
  "count": 4,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "id": "0",
      "name": "overall",
      "displayName": "Overall Standings",
      "links": [
        {
          "language": "en-US",
          "rel": [

Teams

/groups/teams

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/groups/:group_id/teams [View]

{
  "count": 4,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/6"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/19"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/28"
    }
  ]
}

LEADERS

/apis/site/v3/sports/football/nfl/leaders [View]

{
  "currentSeason": {
    "year": 2021,
    "displayName": "2021",
    "startDate": "2021-07-17T07:00:00.000+0000",
    "endDate": "2022-02-16T07:59:00.000+0000",
    "type": {
      "id": "2",
      "type": 2,
      "name": "Regular Season",
      "startDate": "2021-09-09T07:00:00.000+0000",
      "endDate": "2022-01-13T07:59:00.000+0000",
      "week": {
        "number": 15,
        "startDate": "2021-12-15T08:00:00.000+0000",

/v2/sports/football/leagues/nfl/leaders [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0",
  "id": "0",
  "name": "total",
  "abbreviation": "TOTAL",
  "categories": [
    {
      "name": "totalPoints",
      "displayName": "Total Points",
      "shortDisplayName": "TP",
      "abbreviation": "TP",
      "leaders": [
        {
          "displayValue": "2673",
          "value": 2673,

/v2/sports/football/leagues/nfl/leaders/0 [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0",
  "id": "0",
  "name": "total",
  "abbreviation": "TOTAL",
  "categories": [
    {
      "name": "totalPoints",
      "displayName": "Total Points",
      "shortDisplayName": "TP",
      "abbreviation": "TP",
      "leaders": [
        {
          "displayValue": "2673",
          "value": 2673,

NEWS

/apis/site/v2/sports/football/nfl/news [View]

{
  "header": "NFL News",
  "link": {
    "language": "en",
    "rel": [
      "index",
      "desktop",
      "league"
    ],
    "href": "https://www.espn.com/nfl/",
    "text": "All NFL News",
    "shortText": "All News",
    "isExternal": false,
    "isPremium": false
  },

Odds Predictors

/odds/predictors

/v2/sports/football/leagues/nfl/events/:event_id/competitions/:event_id/odds/:provider_id/predictors [View]

{
  "count": 5,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "rank": 1,
      "total": "OVER",
      "value": 90.363,
      "displayValue": "90.4",
      "predictorCompetition": {
      },
      "projectedWinner": {

POSITIONS

/v2/sports/football/leagues/nfl/positions/:position_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8",
  "id": "8",
  "name": "Quarterback",
  "displayName": "Quarterback",
  "abbreviation": "QB",
  "leaf": true,
  "parent": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/70"
  }
}

/v2/sports/football/leagues/nfl/positions [View]

{
  "count": 73,
  "pageIndex": 1,
  "pageSize": 100,
  "pageCount": 1,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/0"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/1"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/2"
    },

PROVIDERS

/v2/sports/football/leagues/nfl/providers/:provider_id [View]

{
  "id": "1003",
  "name": "numberfire",
  "priority": 0
}

SCOREBOARD

/apis/site/v2/sports/football/nfl/scoreboard [View]

{
  "leagues": [
    {
      "id": "28",
      "uid": "s:20~l:28",
      "name": "National Football League",
      "abbreviation": "NFL",
      "slug": "nfl",
      "season": {
        "year": 2021,
        "startDate": "2021-07-17T07:00Z",
        "endDate": "2022-02-16T07:59Z",
        "type": {
          "id": "2",
          "type": 2,

SEASONS

/v2/sports/football/leagues/nfl/seasons [View]

{
  "count": 100,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 4,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2019"
    },

/v2/sports/football/leagues/nfl/seasons/:year [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021",
  "year": 2021,
  "startDate": "2021-07-17T07:00Z",
  "endDate": "2022-02-16T07:59Z",
  "displayName": "2021",
  "type": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2",
    "id": "2",
    "type": 2,
    "name": "Regular Season",
    "abbreviation": "reg",
    "year": 2021,
    "startDate": "2021-09-09T07:00Z",
    "endDate": "2022-01-13T07:59Z",

Athletes

/seasons/athletes

/v2/sports/football/leagues/nfl/seasons/:year/athletes [View]

{
  "count": 16438,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 658,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/4246273"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/4246281"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/4246289"
    },

/v2/sports/football/leagues/nfl/seasons/:year/athletes/:athlete_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876",
  "id": "14876",
  "uid": "s:20~l:28~a:14876",
  "guid": "2d6af5dcb3d3e2d4cf7227d4a8eb93cd",
  "type": "football",
  "alternateIds": {
    "sdr": "2268110"
  },
  "firstName": "Ryan",
  "lastName": "Tannehill",
  "fullName": "Ryan Tannehill",
  "displayName": "Ryan Tannehill",
  "shortName": "R. Tannehill",
  "weight": 217,

Coaches

/seasons/coaches

/v2/sports/football/leagues/nfl/seasons/:year/coaches [View]

{
  "count": 32,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 2,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches/17739"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches/2552857"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches/13162"
    },

Draft

/seasons/draft

/v2/sports/football/leagues/nfl/seasons/:year/draft [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft",
  "uid": "s:20~l:28~e:draft~y:2021",
  "year": 2021,
  "numberOfRounds": 7,
  "displayName": "2021 National Football League Draft",
  "shortDisplayName": "2021 NFL Draft",
  "status": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/status"
  },
  "athletes": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes"
  },
  "rounds": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds"

Futures

/seasons/futures

/v2/sports/football/leagues/nfl/seasons/:year/futures [View]

{
  "count": 7,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561",
      "id": 1561,
      "name": "Pro Football Champion",
      "futures": [
        {
          "provider": {
            "id": "40",
            "name": "DraftKings",

/v2/sports/football/leagues/nfl/seasons/:year/futures/:future_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561",
  "id": 1561,
  "name": "Pro Football Champion",
  "futures": [
    {
      "provider": {
        "id": "40",
        "name": "DraftKings",
        "active": 1,
        "priority": 0
      },
      "books": [
        {
          "team": {

Teams

/seasons/teams

/v2/sports/football/leagues/nfl/seasons/:year/teams [View]

{
  "count": 32,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 2,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/2"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/3"
    },

/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1",
  "id": "1",
  "guid": "49fd392a86fe4df31b779bbfa18b2ad5",
  "uid": "s:20~l:28~t:1",
  "alternateIds": {
    "sdr": "8802"
  },
  "slug": "atlanta-falcons",
  "location": "Atlanta",
  "name": "Falcons",
  "nickname": "Atlanta",
  "abbreviation": "ATL",
  "displayName": "Atlanta Falcons",
  "shortDisplayName": "Falcons",

Types

/seasons/types

/v2/sports/football/leagues/nfl/seasons/:year/types [View]

{
  "count": 4,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/1"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/3"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/4"
    }
  ]
}

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2",
  "id": "2",
  "type": 2,
  "name": "Regular Season",
  "abbreviation": "reg",
  "year": 2021,
  "startDate": "2021-09-09T07:00Z",
  "endDate": "2022-01-13T07:59Z",
  "hasGroups": false,
  "hasStandings": true,
  "hasLegs": false,
  "groups": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups"
  },

TALENTPICKS

/v2/sports/football/leagues/nfl/talentpicks [View]

{
  "count": 176,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 8,
  "items": [
    {
      "pick": {
        "person": {
          "id": "1768",
          "firstName": "Damien",
          "lastName": "Woody",
          "displayName": "Damien Woody",
          "headshot": {
            "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png",

TEAMS

/apis/site/v2/sports/football/nfl/teams [View]

{
  "sports": [
    {
      "id": "20",
      "uid": "s:20",
      "name": "Football",
      "slug": "football",
      "leagues": [
        {
          "id": "28",
          "uid": "s:20~l:28",
          "name": "National Football League",
          "abbreviation": "NFL",
          "shortName": "NFL",
          "slug": "nfl",

/apis/site/v2/sports/football/nfl/teams/:team_id [View]

{
  "team": {
    "id": "1",
    "uid": "s:20~l:28~t:1",
    "slug": "atlanta-falcons",
    "location": "Atlanta",
    "name": "Falcons",
    "nickname": "Atlanta",
    "abbreviation": "ATL",
    "displayName": "Atlanta Falcons",
    "shortDisplayName": "Falcons",
    "color": "000000",
    "alternateColor": "000000",
    "isActive": true,
    "logos": [

Athletes

/teams/athletes

/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/athletes [View]

{
  "count": 76,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 4,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/16963"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3123963"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/16299"
    },

Ats

/teams/ats

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/teams/:team_id/ats [View]

{
  "count": 9,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "wins": 6,
      "losses": 8,
      "pushes": 0,
      "type": {
        "id": "0",
        "name": "atsOverall",
        "description": "Overall team season record against the spread"
      }

Attendance

/teams/attendance

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/teams/:team_id/attendance [View]

{
  "id": "0",
  "name": "Attendance",
  "abbreviation": "ATTND",
  "categories": [
    {
      "name": "home",
      "displayName": "Home",
      "shortDisplayName": "Home",
      "abbreviation": "home",
      "stats": [
        {
          "name": "games",
          "displayName": "Home Games",

Coaches

/teams/coaches

/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/coaches [View]

{
  "count": 1,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
    }
  ]
}

Depthcharts

/teams/depthcharts

/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/depthcharts [View]

{
  "count": 3,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "id": "15",
      "name": "Base 3-4 D",
      "positions": {
        "lde": {
          "position": {
            "id": "11",
            "name": "Left Defensive End",

Events

/teams/events

/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/events [View]

{
  "count": 20,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326621"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326618"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326603"
    },

Injuries

/teams/injuries

/v2/sports/football/leagues/nfl/teams/:team_id/injuries [View]

{
  "count": 63,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 3,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/4408854/injuries/-1252999"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3048898/injuries/499227"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3055899/injuries/499204"
    },

Leaders

/teams/leaders

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/teams/:team_id/leaders [View]

{
  "id": "0",
  "name": "TOTAL",
  "abbreviation": "Any",
  "categories": [
    {
      "name": "passingLeader",
      "displayName": "Passing Leader",
      "shortDisplayName": "PASS",
      "abbreviation": "PYDS",
      "leaders": [
        {
          "displayValue": "360-549, 4052 YDS, 30 TD, 13 INT",
          "value": 4052,

Odds-records

/teams/odds-records

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/teams/:team_id/odds-records [View]

{
  "count": 10,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "abbreviation": "ML",
      "displayName": "Money Line Overall Record",
      "shortDisplayName": "Money Line",
      "type": "moneyLineOverall",
      "stats": [
        {
          "displayName": "Wins",
          "abbreviation": "W",

Projection

/teams/projection

/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/projection [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1/projection",
  "team": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1"
  },
  "chanceToWinThisWeek": 0.59114,
  "chanceToWinDivision": 0,
  "projectedWins": 7.085,
  "projectedLosses": 9.908
}

Record

/teams/record

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/teams/:team_id/record [View]

{
  "count": 5,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "id": "0",
      "name": "All Splits",
      "abbreviation": "Any",
      "type": "total",
      "summary": "10-4",
      "displayValue": "10-4",
      "value": 0.7142857142857143,

Roster

/teams/roster

/apis/site/v2/sports/football/nfl/teams/:team_id/roster [View]

{
  "timestamp": "2021-12-21T12:39:06Z",
  "status": "success",
  "season": {
    "year": 2021,
    "type": 2,
    "name": "Regular Season"
  },
  "coach": [
    {
      "id": "17739",
      "firstName": "Arthur",
      "lastName": "Smith",
      "experience": 0
    }

Schedule

/teams/schedule

/apis/site/v2/sports/football/nfl/teams/:team_id/schedule [View]

{
  "timestamp": "2021-12-21T12:39:07Z",
  "status": "success",
  "season": {
    "year": 2021,
    "type": 2,
    "name": "Regular Season",
    "displayName": "2021",
    "half": 1
  },
  "team": {
    "id": "1",
    "abbreviation": "ATL",
    "location": "Atlanta",
    "name": "Falcons",

Statistics

/teams/statistics

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/teams/:team_id/statistics [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/1/statistics/0",
  "season": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021"
  },
  "team": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1"
  },
  "splits": {
    "id": "0",
    "name": "All Splits",
    "abbreviation": "Any",
    "categories": [
      {
        "name": "general",

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/teams/:team_id/statistics/0 [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics/0",
  "season": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021"
  },
  "team": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12"
  },
  "splits": {
    "id": "0",
    "name": "All Splits",
    "abbreviation": "Any",
    "categories": [
      {
        "name": "general",

Groups

/types/groups

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/groups [View]

{
  "count": 2,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/7"
    }
  ]
}

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/groups/:group_id [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/9",
  "uid": "s:20~l:28~g:9",
  "id": "9",
  "name": "National Football League",
  "abbreviation": "NFL",
  "shortName": "NFL",
  "season": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021"
  },
  "children": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/9/children"
  },
  "standings": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/9/standings"
  },
  "isConference": false,
  "slug": "national-football-league",
  "teams": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/9/teams"
  }
}

Leaders

/types/leaders

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/leaders [View]

{
  "id": "0",
  "name": "TOTAL",
  "abbreviation": "Any",
  "categories": [
    {
      "name": "passingYards",
      "displayName": "Passing Yards",
      "shortDisplayName": "PYDS",
      "abbreviation": "YDS",
      "leaders": [
        {
          "displayValue": "4348",
          "value": 4348,

Weeks

/types/weeks

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks [View]

{
  "count": 18,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/2"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/3"
    },

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks/:weeknum [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6",
  "number": 6,
  "startDate": "2021-10-13T07:00Z",
  "endDate": "2021-10-20T06:59Z",
  "text": "Week 6",
  "teamsOnBye": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20"

VENUES

/v2/sports/football/leagues/nfl/venues/:venue_id [View]

{
  "id": "3493",
  "fullName": "Caesars Superdome",
  "address": {
    "city": "New Orleans",
    "state": "LA",
    "zipCode": "70112"
  },
  "capacity": 73000,
  "grass": false,
  "indoor": true,
  "images": [
    {
      "href": "https://a.espncdn.com/i/venues/nfl/day/3493.jpg",

Events

/weeks/events

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks/:weeknum/events [View]

{
  "$meta": {
    "parameters": {
      "week": [
        "6"
      ],
      "season": [
        "2021"
      ],
      "seasontypes": [
        "2"
      ]
    }
  },
  "count": 14,

Qbr

/weeks/qbr

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks/:weeknum/qbr/10000 [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000",
  "count": 28,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 2,
  "items": [
    {
      "athlete": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/2330"
      },
      "team": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/27"
      },
      "event": {

Talentpicks

/weeks/talentpicks

/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks/:weeknum/talentpicks [View]

{
  "count": 154,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 7,
  "items": [
    {
      "pick": {
        "person": {
          "id": "1768",
          "firstName": "Damien",
          "lastName": "Woody",
          "displayName": "Damien Woody",
          "headshot": {
            "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png",

MISC

/apis/site/v2/sports/football/college-football/scoreboard [View]

{
  "leagues": [
    {
      "id": "23",
      "uid": "s:20~l:23",
      "name": "NCAA - Football",
      "abbreviation": "NCAAF",
      "midsizeName": "NCAA Football",
      "slug": "college-football",
      "season": {
        "year": 2021,
        "startDate": "2021-07-01T07:00Z",
        "endDate": "2022-01-12T07:59Z",
        "type": {
          "id": "3",

/apis/common/v3/search [View]

{
  "count": 44956,
  "pageIndex": 1,
  "pageSize": 15,
  "pageCount": 6654,
  "items": [
    {
      "id": "200",
      "uuid": "b44c545f-8bb4-3505-8019-a0ac3c71db1f",
      "guid": "b44c545f-8bb4-3505-8019-a0ac3c71db1f",
      "displayName": "Cricket",
      "type": "sport",
      "sport": "cricket",
      "relevance": "600000",
      "defaultLeagueSlug": "cricket",

/apis/fantasy/v2/games/ffl/games [View]

{
  "statistics": [
    {
      "id": 2330,
      "gameId": "401326322",
      "proTeamId": "27",
      "positionId": "1",
      "stats": {
        "210": 1,
        "21": 64,
        "1": 32,
        "20": 2,
        "0": 50,
        "4": 4,
        "3": 379,

/apis/v2/scoreboard/header [View]

{
  "sports": [
    {
      "id": "20",
      "uid": "s:20",
      "name": "football",
      "slug": "football",
      "leagues": [
        {
          "id": "28",
          "uid": "s:20~l:28",
          "name": "National Football League",
          "shortName": "NFL",
          "abbreviation": "nfl",
          "slug": "nfl",

/v2/colleges/2509 [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/colleges/2509",
  "id": "2509",
  "mascot": "Boilermakers",
  "name": "Purdue",
  "shortName": "Purdue",
  "abbrev": "PUR"
}

/v2/sports/football/leagues/nfl [View]

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl",
  "id": "28",
  "guid": "ad4c3bd2-ddb6-3f8c-8abf-744855a08fa4",
  "uid": "s:20~l:28",
  "name": "National Football League",
  "abbreviation": "NFL",
  "shortName": "NFL",
  "slug": "nfl",
  "isTournament": false,
  "season": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021",
    "year": 2021,
    "startDate": "2021-07-17T07:00Z",
    "endDate": "2022-02-16T07:59Z",
Raw
espn-nfl-api.md

List of NFL API Endpoints

This page is limited to NFL endpoints but can be refashioned for other sports leagues (i.e. /sports/football/leagues/nfl/ => /sports/baseball/leagues/mlb/)

Parameters

Name Description
:year Integer year in which the season started (YYYY)
:seasontype 1=pre, 2=regular, 3=post
:league_id Fantasy league id
:bet_provider_id Sports betting operator, view under odds
:team_id 1-32 (view all)
:athlete_id view all

Table of Contents:

ESPN Base Urls

site.api.espn[.com]

sports.core.api.espn[.com]

Teams

team api
ATL
 /v2/sports/football/leagues/nfl/seasons/2021/teams/1 /athletes, /depthcharts, /record, /events, /projections
BUF
 /v2/sports/football/leagues/nfl/seasons/2021/teams/2 /athletes, /depthcharts, /record, /events, /projections
CHI
 /v2/sports/football/leagues/nfl/seasons/2021/teams/3 /athletes, /depthcharts, /record, /events, /projections
CIN
 /v2/sports/football/leagues/nfl/seasons/2021/teams/4 /athletes, /depthcharts, /record, /events, /projections
CLE
 /v2/sports/football/leagues/nfl/seasons/2021/teams/5 /athletes, /depthcharts, /record, /events, /projections
DAL
 /v2/sports/football/leagues/nfl/seasons/2021/teams/6 /athletes, /depthcharts, /record, /events, /projections
DEN
 /v2/sports/football/leagues/nfl/seasons/2021/teams/7 /athletes, /depthcharts, /record, /events, /projections
DET
 /v2/sports/football/leagues/nfl/seasons/2021/teams/8 /athletes, /depthcharts, /record, /events, /projections
GB
 /v2/sports/football/leagues/nfl/seasons/2021/teams/9 /athletes, /depthcharts, /record, /events, /projections
TEN
 /v2/sports/football/leagues/nfl/seasons/2021/teams/10 /athletes, /depthcharts, /record, /events, /projections
IND
 /v2/sports/football/leagues/nfl/seasons/2021/teams/11 /athletes, /depthcharts, /record, /events, /projections
KC
 /v2/sports/football/leagues/nfl/seasons/2021/teams/12 /athletes, /depthcharts, /record, /events, /projections
LV
 /v2/sports/football/leagues/nfl/seasons/2021/teams/13 /athletes, /depthcharts, /record, /events, /projections
LAR
 /v2/sports/football/leagues/nfl/seasons/2021/teams/14 /athletes, /depthcharts, /record, /events, /projections
MIA
 /v2/sports/football/leagues/nfl/seasons/2021/teams/15 /athletes, /depthcharts, /record, /events, /projections
MIN
 /v2/sports/football/leagues/nfl/seasons/2021/teams/16 /athletes, /depthcharts, /record, /events, /projections
NE
 /v2/sports/football/leagues/nfl/seasons/2021/teams/17 /athletes, /depthcharts, /record, /events, /projections
NO
 /v2/sports/football/leagues/nfl/seasons/2021/teams/18 /athletes, /depthcharts, /record, /events, /projections
NYG
 /v2/sports/football/leagues/nfl/seasons/2021/teams/19 /athletes, /depthcharts, /record, /events, /projections
NYJ
 /v2/sports/football/leagues/nfl/seasons/2021/teams/20 /athletes, /depthcharts, /record, /events, /projections
PHI
 /v2/sports/football/leagues/nfl/seasons/2021/teams/21 /athletes, /depthcharts, /record, /events, /projections
ARI
 /v2/sports/football/leagues/nfl/seasons/2021/teams/22 /athletes, /depthcharts, /record, /events, /projections
PIT
 /v2/sports/football/leagues/nfl/seasons/2021/teams/23 /athletes, /depthcharts, /record, /events, /projections
LAC
 /v2/sports/football/leagues/nfl/seasons/2021/teams/24 /athletes, /depthcharts, /record, /events, /projections
SF
 /v2/sports/football/leagues/nfl/seasons/2021/teams/25 /athletes, /depthcharts, /record, /events, /projections
SEA
 /v2/sports/football/leagues/nfl/seasons/2021/teams/26 /athletes, /depthcharts, /record, /events, /projections
TB
 /v2/sports/football/leagues/nfl/seasons/2021/teams/27 /athletes, /depthcharts, /record, /events, /projections
WSH
 /v2/sports/football/leagues/nfl/seasons/2021/teams/28 /athletes, /depthcharts, /record, /events, /projections
CAR
 /v2/sports/football/leagues/nfl/seasons/2021/teams/29 /athletes, /depthcharts, /record, /events, /projections
JAX
 /v2/sports/football/leagues/nfl/seasons/2021/teams/30 /athletes, /depthcharts, /record, /events, /projections
BAL
 /v2/sports/football/leagues/nfl/seasons/2021/teams/33 /athletes, /depthcharts, /record, /events, /projections
HOU
 /v2/sports/football/leagues/nfl/seasons/2021/teams/34 /athletes, /depthcharts, /record, /events, /projections

Fantasy

Current season and last 3 years

fantasy.espn.com/apis/v3/games/ffl/seasons/:year/segments/0/leagues/:league_id

League History - get all historical data

fantasy.espn.com/apis/v3/games/ffl/leagueHistory/:league_id?seasonId=:year

Example combining views

https://fantasy.espn.com/apis/v3/games/ffl/leagueHistory/1241838?seasonId=2019&view=mMatchup&view=mMatchupScore

View example combining all

https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mNav

Detailed API

Leagues

sports.core.api.espn.com/v2/sports/football/leagues/nfl

Athletes

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/athletes/:athlete_id

Teams

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams

Team

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id

Plays

sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/plays?limit=300

Depth charts

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/depthcharts

Whitelist dates

sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist

Season

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year

Week

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks/:week

All weeks

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks

List of games via date-range

site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=YYYYMMDD-YYYYMMDD

  • Add &1577413600 at the end for overriding the cache
  • Date range cannot exceed 13 months
  • Format for date can be date range, single date, or year

Betting

bet_provider_id
38 Caesars
31 William Hill
41 SugarHouse
36 Unibet
2000 Bet 365
25 Westgate
45 William Hill (NJ)
1001 accuscore
1004 consensus
1003 numberfire
1002 teamrankings

Odds

sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/odds

Win probabilities

sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/probabilities?limit=200

Against the spread (ATS)

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/2/teams/:team_id/ats

future_id
1561 Super Bowl Winner
2737 AFC South Division Winner
2738 AFC North Division Winner
2739 AFC West Division Winner
2740 AFC East Division Winner
2757 AFC Champion
3904 NFC Champion
3905 NFC North Division Winner
3906 NFC East Division Winner
3907 NFC West Division Winner
3908 NFC South Division Winner

Futures

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/futures/:future_id

Head-to-head (game)

sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/odds/:bet_provider_id/head-to-heads

Odds records

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/0/teams/:team_id/odds-records

Game Odds

sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/odds/:bet_provider_id/history/0/movement?limit=100

Team Odds

sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/odds/:bet_provider_id/past-performances?limit=200

Stats

Positions (enum)

sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100

QBR Weekly/Game stats

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/2/weeks/:week_num/qbr/10000

Athlete

all active athletes

sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?active=true

site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id

site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/splits?season=2021

site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/gamelog

site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/stats

site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/bio

site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/overview

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/athletes/:athlete_id/statistics

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/athletes/:athlete_id/projections

sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/competitors/:team_id/roster/:athlete_id/statistics/0

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/athletes/:athlete_id/eventlog

Team

site.api.espn.com/apis/site/v2/sports/football/nfl/teams

site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id

site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id/roster

site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id/schedule{?season,seasontype}

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/teams/:team_id/statistics

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/projection

sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/odds/1002/past-performances?limit=140

sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/competitors/:team_id/roster?season=YYYY

site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id?enable=roster

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/projection

sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/odds/:bet_provider_id/past-performances?limit=200

Leaders

site.api.espn.com/apis/site/v3/sports/football/nfl/leaders{?season,seasontype}

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders

Scoreboard

site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard{?dates=YYYYMMDD}

Search

site.web.api.espn.com/apis/common/v3/search?region=us&lang=en&query=nfl&limit=5&mode=prefix

site.web.api.espn.com/apis/common/v3/search

site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates={YYYYMMDD}-{YYYYMMDD}&pbpOnly=true

News

site.api.espn.com/apis/site/v2/sports/football/nfl/news

Header

site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl

Misc

sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2/statisticslog

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/athletes?limit=200

Resources

@nntrn
Copy link
Author

nntrn commented Mar 11, 2025

Any chance someone has found an endpoint for the American Hockey League (AHL)?

@MABeatty1978
https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl

List of endpoints for other leagues (mlb, mma, rugby, soccer, etc)
https://gist.githubusercontent.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/b99b9e0d2df72470fa622e2f76cecb0362111e9a/extending-espn-api.md

@nntrn
Copy link
Author

nntrn commented Mar 11, 2025

Is it possible to get live scoring of an actual NFL playoff game for fantasy stats? We do our fantasy playoffs during the actual playoffs and we have been calculated scores by hand, but would love to be able to just connect this API to a google sheet and then create formulas to get our scores. We would use the following score types from the fantasy section.

@tdart5 - i threw a bunch of stuff together but i hope something helps

https://site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId=2977187

https://gambit-api.fantasy.espn.com/apis/v1/dashboards/espn-en?view=allon
https://gambit-api.fantasy.espn.com/apis/v1/challenges/tournament-challenge-bracket-2024/groups/6e682872-7e5f-3aa2-84bf-003cb6a630ae?view=chui_pagetype_group_picks

https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=players_wl
https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=kona_player_info
https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?scoringPeriodId=0&view=allon
https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024?view=proTeamSchedules_wl
https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024?view=chui_default_platformsettings

Header for increasing the limit returned: X-Fantasy-Filter: {"players":{"limit":3000}}

Example 
curl -H 'X-Fantasy-Filter: {"players":{"limit":3000}}' 'https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=players_wl'

@adamruehle
Copy link

As far as I can tell, this url "https://sports.core.api.espn.com/v2/sports/{sport}/leagues/{espn_league}/events/{espn_event_id}/competitions/{espn_event_id}/competitors/{espn_team_id}/roster"
doesn't work for college-football. For example:
https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/%7Bespn_event_id%7D/competitions/401628322/competitors/57/roster
This url is a game between florida and uMiami. The team_id is for Florida. The url doesn't work and returns:
{"error":{"message":"Bad event id: '{espn_event_id}' or league 'college-football' not allowed","code":400}}

@propsdaily
Copy link

propsdaily commented Apr 3, 2025 •
edited
Loading

As far as I can tell, this url "https://sports.core.api.espn.com/v2/sports/{sport}/leagues/{espn_league}/events/{espn_event_id}/competitions/{espn_event_id}/competitors/{espn_team_id}/roster" doesn't work for college-football. For example: https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/%7Bespn_event_id%7D/competitions/401628322/competitors/57/roster This url is a game between florida and uMiami. The team_id is for Florida. The url doesn't work and returns: {"error":{"message":"Bad event id: '{espn_event_id}' or league 'college-football' not allowed","code":400}}

@adamruehle Read the error message, you have a typo in your url (passing '{espn_event_id}' as the first event id in the url:
sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/%7Bespn_event_id%7D/competitions/401628322/competitors/57/roster

Should be:
https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/401628322/competitions/401628322/competitors/57/roster

@dice-bet
Copy link

dice-bet commented Apr 6, 2025 •
edited
Loading

hello, need help getting detailed injury reports per team. I can get it from :
https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/teams/3/injuries

but returns links to individual players without names

i know the roster endpoint gives Status Out/Active but im looking for an endpoint that gives full team statuses with injury report. the ESPN injury page has it all for teams
https://www.espn.com/nba/team/injuries/_/name/chi/chicago-bulls

just cant get it in an endpoint, any help is appreciated thanks

update:

got this to work for individual nba teams

https://site.api.espn.com/apis/site/v2/sports/basketball/nba/injuries?team=ATL

for a matchup

https://site.api.espn.com/apis/site/v2/sports/basketball/nba/injuries?team=ATL&team=NYK
https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/injuries?team=ATL&team=NYY

Looks like you need to use abbreviations

@Azami1990
Copy link

Heyho,

is there a way to get the NFL MVP from the API besides searching the news?

Thanks in advance!

@adamruehle
Copy link

Hi, I'm having trouble figuring out how to get the games for college basketball within a specific date range. This link works:
https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard
But then it only shows me recent or upcoming events like the championship between florida and houston. If I try this link:
https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?limit=1000&dates=20231218-20240107
I see this error on the webpage {"code":404,"message":"Failed to get events endpoint."}

@bakersoft
Copy link

My 2 cents on the ESPN NBA data - it's unreliable and incomplete. You're better off using the NBA static JSON data they have because 1, most of their JSONs contain everything you need to know in a single request, and 2, it's more conducive to better quality data. The ESPN play by play data for example - there are player ID's in recent data for players who aren't active anymore. There are missing data points - my best example is 3 pointers. You only have descriptions to rely on to pull out the data. Sometimes the player names in the descriptions don't match the player ID's. I reverted to pulling the data from ESPN's website and even then, there are not enough data points to pull the info I wanted. The NBA data has the data points built in and there's little guessing.

@nntrn
Copy link
Author

nntrn commented Apr 15, 2025

@adamruehle

if you're trying to target regular season games, my advice is to use
&dates=YYYY&seasontype=2 instead of &dates=YYYYMMDD-YYYYMMDD

--

Endpoints for using &dates=YYYYMMDD-YYYYMMDD

@JimNayzium
Copy link

Concerning the NFL only,
Does anyone know any other status text ESPN uses to signify whehter a game is live in progress or not other than these?

  "STATUS_SCHEDULED" ,
  "STATUS_IN_PROGRESS",
  "STATUS_HALFTIME",
  "STATUS_END_PERIOD",
  "STATUS_FINAL"

For example is there a STATUS_OVERTIME or *_OVER_TIME maybe?
Or STATUS_POST_PONED? etc...

thanks!

@chisox721
Copy link

hello, need help getting detailed injury reports per team. I can get it from : https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/teams/3/injuries

but returns links to individual players without names

i know the roster endpoint gives Status Out/Active but im looking for an endpoint that gives full team statuses with injury report. the ESPN injury page has it all for teams https://www.espn.com/nba/team/injuries/_/name/chi/chicago-bulls

just cant get it in an endpoint, any help is appreciated thanks

update:

got this to work for individual nba teams

https://site.api.espn.com/apis/site/v2/sports/basketball/nba/injuries?team=ATL

for a matchup

https://site.api.espn.com/apis/site/v2/sports/basketball/nba/injuries?team=ATL&team=NYK https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/injuries?team=ATL&team=NYY

Looks like you need to use abbreviations

When I heavily involved in DFS my approach was to use the NBA injury report page and twitter. Maybe things have changed the past couple years but ESPN was always super sketchy with updates.

@chisox721
Copy link

My 2 cents on the ESPN NBA data - it's unreliable and incomplete. You're better off using the NBA static JSON data they have because 1, most of their JSONs contain everything you need to know in a single request, and 2, it's more conducive to better quality data. The ESPN play by play data for example - there are player ID's in recent data for players who aren't active anymore. There are missing data points - my best example is 3 pointers. You only have descriptions to rely on to pull out the data. Sometimes the player names in the descriptions don't match the player ID's. I reverted to pulling the data from ESPN's website and even then, there are not enough data points to pull the info I wanted. The NBA data has the data points built in and there's little guessing.

This. Waste of time messing with ESPN for PBP unless its college basketball/football and the only other option is parsing the archaic ncaa site. MLB/NBA/NFL API's are the way to go.

@famictech2000
Copy link

Does anyone know the URL/end point for the entire 2025 NFL schedule that was released yesterday!?

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard -> Only shows 2025 Week 1

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?seasontype=2&week=1 -> Shows 2024 schedule (for whatever week you put in!?

@propsdaily
Copy link

Does anyone know the URL/end point for the entire 2025 NFL schedule that was released yesterday!?

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard -> Only shows 2025 Week 1

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?seasontype=2&week=1 -> Shows 2024 schedule (for whatever week you put in!?

You could maybe do something like this to get all regular season events:
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2025/types/2/events?limit=1000

@JimNayzium
Copy link

Anyone have a feed link that woud let me see who was OUT for a given week on a roster?
For example, Barkley sat out week 18 for Eagles. But in his roster the active: "false" is set. And it's false for all players so I assume that's just a throw away meaningless thing for that end point.

Any thoughts?

@nntrn
Copy link
Author

nntrn commented Jun 24, 2025

Anyone have a feed link that woud let me see who was OUT for a given week on a roster? For example, Barkley sat out week 18 for Eagles. But in his roster the active: "false" is set. And it's false for all players so I assume that's just a throw away meaningless thing for that end point.

Any thoughts?

@JimNayzium, your definition of OUT isn't clear - what counts as out? present, but didn't play? not present and didn't play?

players in event rosters with .statistics["$ref"] definitely played and players missing this field probably didn't

i think active is a real time field that shows when a player is active during the game.

---

view players from event roster:
/nfl/events/401671841/competitions/401671841/competitors/21/roster

not pratical, but you can validate this by checking each player's eventlog:
/nfl/seasons/2024/athletes/3929630/eventlog

@JimNayzium
Copy link

JimNayzium commented Jun 25, 2025 •
edited
Loading

@nntrn - Thanks so much for the help!
the active explanation makes sense, and thanks for that!
So I just meant the actual injury report status going into the game.
Present, but didn't play is not what I mean at all. A player who dresses out, is on active roster and garners no playing time would not have been "OUT" on the injury report. But Barkley was in a ball cap the entire game week 18, so he would have been OUT week 18.

So for Barkley, on the roster for that week, the didNotPlay === false, does not mean necessarily he was listed as "OUT" if that makes sense?

Also, not having statistics would not be 100 percent accurate either. A WR could go in for a a number of plays, never be targeted and never gain statistics of any kind.

Was just hoping to see a pregame injury report end point of some kind. Or "This week's inactives" type thing.

{
  "playerId": 3929630,
  "period": 0,
  "active": false,
  "starter": false,
  "forPlayerId": 0,
  "jersey": "26",
  "valid": false,
  "athlete": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/athletes/3929630?lang=en&region=us"
  },
  "position": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/9?lang=en&region=us"
  },
  "didNotPlay": false,
  "displayName": "Barkley"
},

@propsdaily
Copy link

propsdaily commented Jun 25, 2025 •
edited
Loading

@nntrn - Thanks so much for the help! the active explanation makes sense, and thanks for that! So I just meant the actual injury report status going into the game. Present, but didn't play is not what I mean at all. A player who dresses out, is on active roster and garners no playing time would not have been "OUT" on the injury report. But Barkley was in a ball cap the entire game week 18, so he would have been OUT week 18.

So for Barkley, on the roster for that week, the didNotPlay === false, does not mean necessarily he was listed as "OUT" if that makes sense?

Also, not having statistics would not be 100 percent accurate either. A WR could go in for a a number of plays, never be targeted and never gain statistics of any kind.

Was just hoping to see a pregame injury report end point of some kind. Or "This week's inactives" type thing.

{
  "playerId": 3929630,
  "period": 0,
  "active": false,
  "starter": false,
  "forPlayerId": 0,
  "jersey": "26",
  "valid": false,
  "athlete": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/athletes/3929630?lang=en&region=us"
  },
  "position": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/9?lang=en&region=us"
  },
  "didNotPlay": false,
  "displayName": "Barkley"
},

@JimNayzium I'm not sure if this would help pre-game but for post, you could check their event log.

It looks like it shows a played => true/false, and for week 18 on Barkley it shows false.

@dice-bet
Copy link

dice-bet commented Jul 1, 2025 •
edited
Loading

Does anyone know the URL/end point for the entire 2025 NFL schedule that was released yesterday!?
https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard -> Only shows 2025 Week 1
https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?seasontype=2&week=1 -> Shows 2024 schedule (for whatever week you put in!?

You could maybe do something like this to get all regular season events: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2025/types/2/events?limit=1000

https://cdn.espn.com/core/nfl/schedule?xhr=1

@ryanbuckner
Copy link

ryanbuckner commented Jul 2, 2025 via email

@johnpuksta
Copy link

Noticed something odd:

For the 2024 events API, it doesn't return playoff games past the 1st divisional round. For example, for the Eagles (ID = 21), you can see the response of https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/teams/21/events is missing Games 401671889 (SuperBowl) and 401671888 (NFC champ).

For previous years (2023 season), I verified that all games were there (pre, in, post season).

I checked the other Events API: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events?season=2024&seasontypes=3&page=3. Here you can filter by page to go through each result. None of these pages contain these missing games either.

Do we think ESPN forgot to track these games or is there a new playoffs API?

@aaronweldy
Copy link

If anyone's interested, I've gotten pretty far in creating an OpenAPI spec for all of the endpoints listed here + more: https://github.com/aaronweldy/espn-openapi

Fully types out the response schema & is easy to create generated clients for whatever language you want with your favorite OpenAPI generator.

@KieranMunslow
Copy link

Hi, a specific one regarding the NFL. Is anyone aware of a way to view the correct values for passing yards after catch? Receiving yards after catch seems fine but passing yards after catch I'm struggling to find.
The player stats of an event don't have that stat (e.g. https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401671764)
And the statistics section of a player's event log has the stat, but its seemingly 0 no matter what
(e.g. Jared Goff and Amon-Ra for the same Lions-Cowboys game
Goff - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671764/competitions/401671764/competitors/8/roster/3046779/statistics/0?lang=en&region=us
Amon Ra - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671764/competitions/401671764/competitors/8/roster/4374302/statistics/0?lang=en&region=us)

@nntrn
Copy link
Author

nntrn commented Jul 15, 2025

Hi, a specific one regarding the NFL. Is anyone aware of a way to view the correct values for passing yards after catch? Receiving yards after catch seems fine but passing yards after catch I'm struggling to find.

You can get this in the play by play
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671764/competitions/401671764/plays?limit=300

This is what I see for Goff btw:

  {
    "name": "passingYards",
    "displayName": "Passing Yards",
    "shortDisplayName": "Pass Yards",
    "description": "The total passing yards.",
    "abbreviation": "YDS",
    "value": 315.0,
    "displayValue": "315",
  },
  {
    "name": "passingYardsAtCatch",
    "displayName": "Passing Yards At Catch",
    "shortDisplayName": "PY@C",
    "description": "The amount of passing yards when the catch is made.",
    "abbreviation": "PY@C",
    "value": 315.0,
    "displayValue": "315"
  },
  {
    "name": "passingYardsPerGame",
    "displayName": "Passing Yards Per Game",
    "shortDisplayName": "PYDS/G",
    "description": "The number of passing yards per game.",
    "abbreviation": "YDS/G",
    "value": 315.0,
    "displayValue": "315.0"
  }

@KieranMunslow

@KieranMunslow
Copy link

Hi, a specific one regarding the NFL. Is anyone aware of a way to view the correct values for passing yards after catch? Receiving yards after catch seems fine but passing yards after catch I'm struggling to find.

You can get this in the play by play https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671764/competitions/401671764/plays?limit=300

This is what I see for Goff btw:

@KieranMunslow

Ah I never noticed it in the play by play section, thanks @nntrn. I'll have to take a look and see if there is a realistic way for me to total them and attribute to correct QB.

The stats I was more referring to as in the Goff example was the 2 below. PYAC ideally should be 180 and PY@C should be 135.

{ "name": "passingYardsAfterCatch", "displayName": "Passing Yards After Catch", "shortDisplayName": "PYAC", "description": "The amount of passing yards after catch.", "abbreviation": "PYAC", "value": 0, "displayValue": "0" }, { "name": "passingYardsAtCatch", "displayName": "Passing Yards At Catch", "shortDisplayName": "PY@C", "description": "The amount of passing yards when the catch is made.", "abbreviation": "PY@C", "value": 315, "displayValue": "315" }

@macsochor
Copy link

Thank you so much for putting this together! I am creating a website to run an alternate rules DFS contest for my friends and I wanted to add live scoring. I'll only need to fetch the scores for around 50 players, what endpoint do you think would be best for this?

I see that I could potentially make a call to each player endpoint or to each game endpoint, but I'm guessing that I could add headers to one of these requests to just get the stats for the games happening today for only a certain set of playerIds. Does any endpoint come to mind?

I can probably hack it all together with the existing ones, I just don't want to spam the api and parse through a bunch of data if I don't have to

@nntrn
Copy link
Author

nntrn commented Jul 27, 2025

I see that I could potentially make a call to each player endpoint or to each game endpoint, but I'm guessing that I could add headers to one of these requests to just get the stats for the games happening today for only a certain set of playerIds. Does any endpoint come to mind?

@macsochor, if you want players playing THAT day, check out the xhr links

@guizucolotto
Copy link

I think I missed something, what call do I get the information from the Stats example at the end of this .md?

@JimNayzium
Copy link

I have a fun one that is quite maddening. (No pun intended)
In the drive play-by-play feed from a Bills game week 1 with id: 401671617
There was a discrepancy in the totals I was getting for James Cook's stats and I found a mistake by ESPN apparently.
I see no real way to know the mistake should be discounted or removed in the feeds either, at least not in these feeds. Other than comparing the stat totals at the end, but then determining what is wrong is near impossible.

I compared the PDF at nfl.com of the play by play hard copy of the actual game on these two plays and it would seem that the James Cook 11 yard rush does not exist at all. Somehow it just got entered for James Cook. Typically if a penalty happens or a play is reviewed that is well documented by ESPN's feeds. This is a pure mistake I am afraid. Like the intern who entered the data just shanked.

To be clear, this first play just doesn't appear in the https://static.www.nfl.com/gamecenter/7d40236a-1312-11ef-afd1-646009f18b2e.pdf report here. And if you look at the json data you will see the same exact clock times.

I guess this is the type thing that causes a "stat" correction to be made in fantasy maybe?

Any thoughts on a way to detect these type things? Something I am missing?

{
			"id": "4016716173400",
			"end": {
				"down": 1,
				"team": {
					"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/teams/2?lang=en&region=us"
				},
				"distance": 13,
				"yardLine": 43,
				"possessionText": "BUF 43",
				"yardsToEndzone": 57,
				"downDistanceText": "1st & 13 at BUF 43",
				"shortDownDistanceText": "1st & 13"
			},
			"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/plays/4016716173400?lang=en&region=us",
			"team": {
				"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/teams/2?lang=en&region=us"
			},
			"text": "(Shotgun) J.Cook to BUF 43 for 11 yards.",
			"type": {
				"id": "5",
				"text": "Rush",
				"abbreviation": "RUSH"
			},
			"clock": {
				"value": 449,
				"displayValue": "7:29"
			},
			"drive": {
				"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/drives/40167161716?lang=en&region=us"
			},
			"start": {
				"down": 2,
				"team": {
					"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/teams/2?lang=en&region=us"
				},
				"distance": 8,
				"yardLine": 32,
				"possessionText": "BUF 32",
				"yardsToEndzone": 68,
				"downDistanceText": "2nd & 8 at BUF 32",
				"shortDownDistanceText": "2nd & 8"
			},
			"period": {
				"number": 4
			},
			"modified": "2024-09-11T20:51Z",
			"priority": false,
			"awayScore": 28,
			"homeScore": 31,
			"shortText": "James Cook 11 Yd Rush",
			"wallclock": "2024-09-08T19:40:06Z",
			"scoreValue": 0,
			"probability": {
				"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/probabilities/4016716173400?lang=en&region=us"
			},
			"scoringPlay": false,
			"statYardage": 11,
			"participants": [
				{
					"type": "rusher",
					"order": 1,
					"stats": [
						{
							"name": "rushingAttempts",
							"value": 19,
							"description": "The total number of attempted rushes.",
							"displayName": "Rushing Attempts",
							"abbreviation": "ATT",
							"displayValue": "19",
							"shortDisplayName": "Rushing Attempts"
						},
						{
							"name": "rushingYards",
							"value": 71,
							"description": "The total rushing yards.",
							"displayName": "Rushing Yards",
							"abbreviation": "YDS",
							"displayValue": "71",
							"shortDisplayName": "Rush Yards"
						},
						{
							"name": "rushingTouchdowns",
							"value": 0,
							"description": "The total number of rushing touchdowns.",
							"displayName": "Rushing Touchdowns",
							"abbreviation": "TD",
							"displayValue": "0",
							"shortDisplayName": "Rushing Touchdowns"
						}
					],
					"athlete": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/athletes/4379399?lang=en&region=us"
					},
					"position": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/9?lang=en&region=us"
					},
					"statistics": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/competitors/2/roster/4379399/statistics/0?lang=en&region=us"
					}
				}
			],
			"sequenceNumber": "340000",
			"alternativeText": "(Shotgun) J.Cook to BUF 43 for 11 yards.",
			"yardsAfterCatch": 0,
			"shortAlternativeText": "James Cook 11 Yd Rush"
		},
		{
			"id": "4016716173426",
			"end": {
				"down": 2,
				"team": {
					"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/teams/2?lang=en&region=us"
				},
				"distance": 11,
				"yardLine": 43,
				"possessionText": "BUF 43",
				"yardsToEndzone": 57,
				"downDistanceText": "2nd & 11 at BUF 43",
				"shortDownDistanceText": "2nd & 11"
			},
			"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/plays/4016716173426?lang=en&region=us",
			"team": {
				"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/teams/2?lang=en&region=us"
			},
			"text": "J.Allen pass short left to D.Kincaid to BUF 43 for 11 yards (S.Murphy-Bunting, O.Pappoe).",
			"type": {
				"id": "24",
				"text": "Pass Reception",
				"abbreviation": "REC"
			},
			"clock": {
				"value": 449,
				"displayValue": "7:29"
			},
			"drive": {
				"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/drives/40167161716?lang=en&region=us"
			},
			"start": {
				"down": 2,
				"team": {
					"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/teams/2?lang=en&region=us"
				},
				"distance": 8,
				"yardLine": 32,
				"possessionText": "BUF 32",
				"yardsToEndzone": 68,
				"downDistanceText": "2nd & 8 at BUF 32",
				"shortDownDistanceText": "2nd & 8"
			},
			"period": {
				"number": 4
			},
			"modified": "2024-09-11T20:51Z",
			"priority": false,
			"awayScore": 28,
			"homeScore": 31,
			"shortText": "Josh Allen Pass Complete for 11 Yds to Dalton Kincaid",
			"wallclock": "2024-09-08T19:39:58Z",
			"scoreValue": 0,
			"probability": {
				"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/probabilities/4016716173426?lang=en&region=us"
			},
			"scoringPlay": false,
			"statYardage": 11,
			"participants": [
				{
					"type": "passer",
					"order": 1,
					"stats": [
						{
							"name": "completions/attempts",
							"value": 0.7826086957,
							"description": "The number of passing completions and attempts.",
							"displayName": "Completions / Attempts",
							"abbreviation": "COMP/ATT",
							"displayValue": "18/23",
							"shortDisplayName": "COMP/ATT"
						},
						{
							"name": "passingYards",
							"value": 232,
							"description": "The total passing yards.",
							"displayName": "Passing Yards",
							"abbreviation": "YDS",
							"displayValue": "232",
							"shortDisplayName": "Pass Yards"
						},
						{
							"name": "passingTouchdowns",
							"value": 2,
							"description": "The total number of passing touchdowns.",
							"displayName": "Passing Touchdowns",
							"abbreviation": "TD",
							"displayValue": "2",
							"shortDisplayName": "Touchdowns"
						},
						{
							"name": "interceptions",
							"value": 0,
							"description": "The total number of interceptions.",
							"displayName": "Interceptions",
							"abbreviation": "INT",
							"displayValue": "0",
							"shortDisplayName": "Interceptions"
						}
					],
					"athlete": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/athletes/3918298?lang=en&region=us"
					},
					"position": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8?lang=en&region=us"
					},
					"statistics": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/competitors/2/roster/3918298/statistics/0?lang=en&region=us"
					}
				},
				{
					"type": "receiver",
					"order": 2,
					"stats": [
						{
							"name": "receptions",
							"value": 1,
							"description": "The total number of receptions.",
							"displayName": "Receptions",
							"abbreviation": "REC",
							"displayValue": "1",
							"shortDisplayName": "Receptions"
						},
						{
							"name": "receivingYards",
							"value": 11,
							"description": "The total receiving yards.",
							"displayName": "Receiving Yards",
							"abbreviation": "YDS",
							"displayValue": "11",
							"shortDisplayName": "Rec. Yards"
						},
						{
							"name": "receivingTouchdowns",
							"value": 0,
							"description": "The total number of receiving touchdowns.",
							"displayName": "Receiving Touchdowns",
							"abbreviation": "TD",
							"displayValue": "0",
							"shortDisplayName": "Receiving Touchdowns"
						}
					],
					"athlete": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/athletes/4385690?lang=en&region=us"
					},
					"position": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/7?lang=en&region=us"
					},
					"statistics": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/competitors/2/roster/4385690/statistics/0?lang=en&region=us"
					}
				},
				{
					"type": "tackler",
					"order": 3,
					"stats": [
						{
							"name": "totalTackles",
							"value": 5,
							"description": "The total number of tackles.",
							"displayName": "Total Tackles",
							"abbreviation": "TOT",
							"displayValue": "5",
							"shortDisplayName": "Tackles"
						},
						{
							"name": "sacks",
							"value": 0,
							"description": "The total number of sacks.",
							"displayName": "Sacks",
							"abbreviation": "SACK",
							"displayValue": "0",
							"shortDisplayName": "Sacks"
						},
						{
							"name": "interceptions",
							"value": 0,
							"description": "The total number of interceptions.",
							"displayName": "Interceptions",
							"abbreviation": "INT",
							"displayValue": "0",
							"shortDisplayName": "Interceptions"
						}
					],
					"athlete": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/athletes/3932886?lang=en&region=us"
					},
					"position": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/29?lang=en&region=us"
					},
					"statistics": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/competitors/22/roster/3932886/statistics/0?lang=en&region=us"
					}
				},
				{
					"type": "assistedBy",
					"order": 4,
					"stats": [
						{
							"name": "totalTackles",
							"value": 4,
							"description": "The total number of tackles.",
							"displayName": "Total Tackles",
							"abbreviation": "TOT",
							"displayValue": "4",
							"shortDisplayName": "Tackles"
						},
						{
							"name": "sacks",
							"value": 0,
							"description": "The total number of sacks.",
							"displayName": "Sacks",
							"abbreviation": "SACK",
							"displayValue": "0",
							"shortDisplayName": "Sacks"
						},
						{
							"name": "interceptions",
							"value": 0,
							"description": "The total number of interceptions.",
							"displayName": "Interceptions",
							"abbreviation": "INT",
							"displayValue": "0",
							"shortDisplayName": "Interceptions"
						}
					],
					"athlete": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/athletes/4567219?lang=en&region=us"
					},
					"position": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/30?lang=en&region=us"
					},
					"statistics": {
						"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671617/competitions/401671617/competitors/22/roster/4567219/statistics/0?lang=en&region=us"
					}
				}
			],
			"sequenceNumber": "342600",
			"alternativeText": "J.Allen pass short left to D.Kincaid to BUF 43 for 11 yards (S.Murphy-Bunting, O.Pappoe).",
			"yardsAfterCatch": 0,
			"shortAlternativeText": "Josh Allen Pass Complete for 11 Yds to Dalton Kincaid"
		},

@KieranMunslow
Copy link

@JimNayzium, I've taken a look at what you've mentioned and think you're spot on with this being a phantom play.

In terms of detecting things like this, it seems pretty tough as the non-existent play is populated as though its real. The one discrepancy I can find is the value of the wallclock field. I've listed a few plays around the play you're looking and the fake Cook play breaks the sequence. Its hard to know if this will be the case in other instances though.

The real Cook rush with penalty on play - 2024-09-08T19:39:07Z
The phantom Cook rush - 2024-09-08T19:40:06Z
The Kincaid pass - 2024-09-08T19:39:58Z
The Cook rush for loss of 3 yards - 2024-09-08T19:40:41Z

Also out of curiosity, what URL are you requesting this data from? My responses all lacked the "yardsAfterCatch": 0 for the Kincaid pass which you seem to have.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment