List of nfl api endpoints from espn

espn-api-list.md

List of NFL API Endpoints

This page has been updated a lot in the past 2 years. It might be helpful to look at older revisions. View latest here

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/)

Additional Resources / Further Reading

• nfl-nerd
• ESPN's hidden API endpoints
• Using ESPN's new Fantasy API (v3)
• ESPN: Get Endpoint (CRAN Package)

---

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	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
:team_id	1-32 (view all)
:athlete_id	view all

Getting started

API for getting ids:

• Athletes: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true
• Teams: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams?limit=32
• Positions: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=75
• Venues: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues?limit=700

Odds:

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

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

• Against-the-spread: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/types/2/teams/:team_id/ats

• Futures: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/futures

• 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/:season/types/0/teams/:team_id/odds-records

• Game odds: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/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

• 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/:season/types/2/weeks/:week_num/qbr/10000

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

Teams:

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

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

• Roster: site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id/roster?enable=roster,projection,stats

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

• Schedule: site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id/schedule?season=:year

• Injuries: sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/injuries

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

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

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

Games:

• Game summary: site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=:game_id

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

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

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

• Events: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events

• get game ids: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks/:week/events

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

• free agents: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/freeagents

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

• current season game dates: sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist

• blacklist: sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist

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

League:

• transactions: sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions

• group: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/groups/:group_id

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

• franchises: sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises

Scoreboard:

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

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

• site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=YYYY

• All weeks in given season: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks

Performance:

• Current leaders: sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders

• Leaders (filter): site.api.espn.com/apis/site/v3/sports/football/nfl/leaders{?season,seasontype}

• Leaders (year): sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/leaders

• Talent picks: sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks

• Athletes: sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limits=200

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

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

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

---

/apis/common/v3/search

Example: https://site.web.api.espn.com/apis/common/v3/search?limit=100&query=nfl

Results

{
  "count": 8,
  "pageIndex": 1,
  "pageSize": 205,
  "pageCount": 1,
  "items": [
    {
      "id": "28",
      "uuid": "ad4c3bd2-ddb6-3f8c-8abf-744855a08fa4",
      "guid": "ad4c3bd2-ddb6-3f8c-8abf-744855a08fa4",
      "displayName": "National Football League",
      "type": "league",
      "sport": "football",
      "league": "nfl",
      "relevance": "559650519",
      "defaultLeagueSlug": "nfl",
      "uid": "s:20~l:28",
      "abbreviation": "NFL",

/apis/fantasy/v2/games/ffl/games

Example: https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108

Results

{
  "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

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

Results

{
  "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",
          "isTournament": false,
          "events": [
            {
              "gamecastAvailable": true,
              "playByPlayAvailable": true,
              "commentaryAvailable": false,
              "recent": false,
              "id": "401326598",
              "competitionId": "401326598",
              "uid": "s:20~l:28~e:401326598~c:401326598",
              "date": "2022-01-08T21:30:00Z",
              "timeValid": true,
              "name": "Kansas City Chiefs at Denver Broncos",
              "shortName": "KC @ DEN",
              "location": "Empower Field at Mile High",
              "season": 2021,
              "seasonStartDate": "2021-07-17T07:00:00Z",
              "seasonEndDate": "2022-01-13T07:59:00Z",

/v3/colleges/2509

Example: https://sports.core.api.espn.com/v3/colleges/2509

Results

{
  "id": "2509",
  "mascot": "Boilermakers",
  "name": "Purdue",
  "longName": "Purdue University",
  "shortName": "Purdue",
  "abbreviation": "PUR"
}

/v2/sports/football/leagues/nfl

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl

Results

{
  "$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",

ATHLETES

/apis/common/v3/sports/football/nfl/athletes/athlete_id

Example: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000

Results

{
  "count": 4559,
  "pageIndex": 1,
  "pageSize": 1000,
  "pageCount": 5,
  "items": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2576336?lang=en&region=us"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3049325?lang=en&region=us"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3915373?lang=en&region=us"
    },

/v2/sports/football/leagues/nfl/athletes/athlete_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876

Results

{
  "$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,

ATHLETE BIO

/apis/common/v3/sports/football/nfl/athletes/athlete_id/bio

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

Results

{
  "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",

ATHLETE EVENTLOG

/v2/sports/football/leagues/nfl/seasons/year/athletes/athlete_id/eventlog

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/eventlog

Results

{
  "$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,

ATHLETE GAMELOG

/apis/common/v3/sports/football/nfl/athletes/athlete_id/gamelog

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

Results

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

ATHLETE NOTES

/v2/sports/football/leagues/nfl/seasons/year/athletes/athlete_id/notes

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/notes

Results

{
  "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"
    }
  ]
}

ATHLETE PROJECTIONS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/athletes/athlete_id/projections

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/projections

Results

{
  "$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": [
      {

ATHLETE SPLITS

/apis/common/v3/sports/football/nfl/athletes/athlete_id/splits

Example: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits

Results

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

ATHLETE STATISTICS

/v2/sports/football/leagues/nfl/athletes/athlete_id/statistics/0

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statistics/0

Results

{
  "$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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics

Results

{
  "$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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0

Results

{
  "$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": [
      {

ATHLETE STATISTICSLOG

/v2/sports/football/leagues/nfl/athletes/athlete_id/statisticslog

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog

Results

{
  "$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"
          }
        },
        {

ATHLETE STATS

/apis/common/v3/sports/football/nfl/athletes/athlete_id/stats

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

Results

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

CALENDAR

/v2/sports/football/leagues/nfl/calendar

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar

Results

{
  "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"
    }
  ]
}

CALENDAR BLACKLIST

/v2/sports/football/leagues/nfl/calendar/blacklist

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist

Results

{
  "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",

CALENDAR WHITELIST

/v2/sports/football/leagues/nfl/calendar/whitelist

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

Results

{
  "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",

COMPETITION DRIVES

/v2/sports/football/leagues/nfl/events/event_id/competitions/event_id/drives/drive_id

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/drives/4012490631

Results

{
  "$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

COMPETITION ODDS

/v2/sports/football/leagues/nfl/events/event_id/competitions/event_id/odds

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/odds

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003

Results

{
  "$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,

COMPETITION PLAYS

/v2/sports/football/leagues/nfl/events/event_id/competitions/event_id/plays/play_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631

Results

{
  "$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

GETS ALL PLAYS FOR A GAME: Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?limit=400

Results

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?source=2",
  "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"
      },

COMPETITION PROBABILITIES

/v2/sports/football/leagues/nfl/events/event_id/competitions/event_id/probabilities/probabilities_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631

Results

{
  "$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

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

Results

{
  "count": 166,
  "pageIndex": 1,
  "pageSize": 200,
  "pageCount": 1,
  "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": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/teams/34"
      },
      "awayTeam": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/teams/33"
      },
      "tiePercentage": 0,
      "homeWinPercentage": 0.312,
      "awayWinPercentage": 0.688,
      "lastModified": "2020-09-21T00:14Z",
      "sequenceNumber": "100",
      "source": {
        "id": "2",
        "description": "feed",
        "state": "full"
      },
      "secondsLeft": 0
    },

COMPETITOR ROSTER

/v2/sports/football/leagues/nfl/events/event_id/competitions/event_id/competitors/competitors_id/roster

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster

Results

{
  "$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": {

DRAFT ATHLETES

/v2/sports/football/leagues/nfl/seasons/year/draft/athletes

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes?limit=500

Results

{
  "count": 366,
  "pageIndex": 1,
  "pageSize": 500,
  "pageCount": 1,
  "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"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104933"

DRAFT ROUNDS

/v2/sports/football/leagues/nfl/seasons/year/draft/rounds

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds

Results

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

DRAFT STATUS

/v2/sports/football/leagues/nfl/seasons/year/draft/status

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/status

Results

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

EVENTS

/v2/sports/football/leagues/nfl/events

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events

Results

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

/v2/sports/football/leagues/nfl/events/event_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315

Results

{
  "$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"

EVENT COMPETITIONS

/v2/sports/football/leagues/nfl/events/event_id/competitions/event_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1

Results

{
  "$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": [
    {

GROUP STANDINGS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/groups/group_id/standings

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/standings

Results

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

GROUP TEAMS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/groups/group_id/teams

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/teams

Results

{
  "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

Example: https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021

Results

  "leaders": {
    "id": "0",
    "name": "TOTAL",
    "abbreviation": "Any",
    "categories": [
      {
        "name": "passingYards",
        "displayName": "Passing Yards",
        "abbreviation": "YDS",
        "leaders": [
          {
            "displayValue": "404",
            "value": 404,
            "rel": [
              "athlete"
            ],
            "athlete": {
              "id": "3139477",
              "uid": "s:20~l:28~a:3139477",
              "guid": "37d87523280a9d4a0adb22cfc6d3619c",
              "firstName": "Patrick",
              "lastName": "Mahomes",
              "displayName": "Patrick Mahomes",
              "fullName": "Patrick Mahomes",

/v2/sports/football/leagues/nfl/leaders

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders

Results

{
  "$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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0

Results

{
  "$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

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

Results

{
  "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
  },

ODD PREDICTORS

/v2/sports/football/leagues/nfl/events/event_id/competitions/event_id/odds/provider_id/predictors

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003/predictors

Results

{
  "count": 5,
  "pageIndex": 1,
  "pageSize": 25,
  "pageCount": 1,
  "items": [
    {
      "rank": 1,
      "total": "OVER",
      "value": 90.363,
      "displayValue": "90.4",
      "predictorCompetition": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315"
      },
      "projectedWinner": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8"
      },
      "cover": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8"
      },
      "projectedCover": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1"
      }
    },

POSITIONS

/v2/sports/football/leagues/nfl/positions/position_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8

Results

{
  "$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

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

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003

Results

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

SCOREBOARD

/apis/site/v2/sports/football/nfl/scoreboard

Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard

Results

{
  "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

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

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021

Results

{
  "$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",

SEASON ATHLETES

/v2/sports/football/leagues/nfl/seasons/year/athletes

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876

Results

{
  "$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,

SEASON COACHES

/v2/sports/football/leagues/nfl/seasons/year/coaches

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches?limit=50

Results

{
  "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"
    },

/v2/sports/football/leagues/nfl/seasons/year/coaches/coach_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695

Results

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695",
  "id": "4408695",
  "uid": "s:20~l:28~co:4408695",
  "firstName": "Kevin",
  "lastName": "Stefanski",
  "team": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/5"
  },
  "experience": 1,
  "careerRecords": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695/record/0"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695/record/2"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695/record/3"
    }
  ],
  "coachSeasons": [
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/coaches/4408695"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches/4408695"
    }
  ]
}

SEASON DRAFT

/v2/sports/football/leagues/nfl/seasons/year/draft

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft

Results

{
  "$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"

SEASON FUTURES

/v2/sports/football/leagues/nfl/seasons/year/futures

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561

Results

{
  "$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": {

SEASON TEAMS

/v2/sports/football/leagues/nfl/seasons/year/teams

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12

Results

{
  "$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",

SEASON TYPES

/v2/sports/football/leagues/nfl/seasons/year/types

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2

Results

{
  "$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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks

Results

{
  "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",

TEAM

/apis/site/v2/sports/football/nfl/teams

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

Results

{
  "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

Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12

Results

{
  "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": [

TEAM ATHLETES

/v2/sports/football/leagues/nfl/seasons/year/teams/team_id/athletes

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/athletes

Results

{
  "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"
    },

TEAM ATS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/teams/team_id/ats

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/ats

Results

{
  "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"
      }

TEAM ATTENDANCE

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/teams/team_id/attendance

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/attendance

Results

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

TEAM COACHES

/v2/sports/football/leagues/nfl/seasons/year/teams/team_id/coaches

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/coaches

Results

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

TEAM DEPTHCHARTS

/v2/sports/football/leagues/nfl/seasons/year/teams/team_id/depthcharts

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/depthcharts

Results

{
  "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",

TEAM EVENTS

/v2/sports/football/leagues/nfl/seasons/year/teams/team_id/events

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/events

Results

{
  "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"
    },

TEAM INJURIES

/v2/sports/football/leagues/nfl/teams/team_id/injuries

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/12/injuries

Results

{
  "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"
    },

TEAM LEADERS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/teams/team_id/leaders

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/leaders

Results

{
  "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,

TEAM ODDS-RECORDS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/teams/team_id/odds-records

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/odds-records

Results

{
  "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",

TEAM PROJECTION

/v2/sports/football/leagues/nfl/seasons/year/teams/team_id/projection

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/projection

Results

{
  "$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
}

TEAM RECORD

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/teams/team_id/record

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/record

Results

{
  "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,

TEAM ROSTER

/apis/site/v2/sports/football/nfl/teams/team_id/roster

Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/roster

Results

{
  "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
    }

TEAM SCHEDULE

/apis/site/v2/sports/football/nfl/teams/team_id/schedule

Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/schedule

Results

{
  "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",

TEAM STATISTICS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/teams/team_id/statistics

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics

Results

{
  "$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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics/0

Results

{
  "$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",

SEASONTYPE GROUPS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/groups

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1

Results

{
  "$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"
  }
}

SEASONTYPE LEADERS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/leaders

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

Results

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/3/leaders",
  "id": "0",
  "name": "TOTAL",
  "abbreviation": "Any",
  "categories": [
    {
      "name": "passingYards",
      "displayName": "Passing Yards",
      "shortDisplayName": "PYDS",
      "abbreviation": "YDS",
      "leaders": [
        {
          "displayValue": "404",
          "value": 404,
          "rel": [
            "athlete"
          ],
          "athlete": {
            "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3139477"
          },
          "team": {
            "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12"
          },
          "statistics": {
            "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/3/athletes/3139477/statistics/0"
          }
        },

SEASONTYPE WEEKS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/weeks

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks

Results

{
  "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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6

Results

{
  "$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

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493

Results

{
  "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",

WEEKLY EVENTS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/weeks/weeknum/events

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/events

Results

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

WEEKLY QBR

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/weeks/weeknum/qbr/10000

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000

Results

{
  "$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": {

WEEKLY TALENTPICKS

/v2/sports/football/leagues/nfl/seasons/year/types/seasontype/weeks/weeknum/talentpicks

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/talentpicks

Results

{
  "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",

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.

@adamruehle

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

• https://sportscenter.api.espn.com/apis/v1/events?sport=basketball&league=mens-college-basketball&dates=2020&limit=400&seasontype=2

• https://site.mobile.api.espn.com/apis/mobile/v2/event/header?profile=sportscenter_v1&sport=basketball&league=mens-college-basketball&dates=2020&seasontype=2&limit=200

• https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?limit=100&seasontype=2&dates=2023

--

Endpoints for using &dates=YYYYMMDD-YYYYMMDD

• https://sportscenter.api.espn.com/apis/v1/events?sport=basketball&league=mens-college-basketball&dates=20231218-20240107

• https://site.web.api.espn.com/apis/personalized/v2/scoreboard/header?sport=basketball&league=mens-college-basketball&dates=20231218-20240107&limit=200

• https://site.mobile.api.espn.com/apis/mobile/v2/event/header?profile=sportscenter_v1&sport=basketball&league=mens-college-basketball&dates=20231218-20240107&limit=100

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!

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.

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.

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!?

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

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?

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

@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"
},

@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.

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

I wrote a GAS project to hit these endpoints. You can see it here https://www.reddit.com/r/googlesheets/comments/1kmk9qp/real_time_nfl_scores_google_sheet_202526_season/

…

On Tue, Jul 1, 2025 at 6:31 PM dice-bet ***@***.***> wrote: ***@***.**** commented on this gist. ------------------------------ 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 need to use cdn endpoint — Reply to this email directly, view it on GitHub <https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c#gistcomment-5654153> or unsubscribe <https://github.com/notifications/unsubscribe-auth/AANTBKPJPPUNUDWEYEGDNJT3GMD2ZBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDUOJ2WLJDOMFWWLO3UNBZGKYLEL5YGC4TUNFRWS4DBNZ2F6YLDORUXM2LUPGBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVEYTANRXGA2DANZTU52HE2LHM5SXFJTDOJSWC5DF> . You are receiving this email because you commented on the thread. Triage notifications on the go with GitHub Mobile for iOS <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> or Android <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub> .

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?

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.

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)

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

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" }

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

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

• https://cdn.espn.com/core/nfl/game?xhr=1&gameId=401127922
• https://cdn.espn.com/core/nfl/schedule?xhr=1&year=2025&week=1
• more in gist

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

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"
		},

@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.

@guizucolotto

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

https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2025?view=chui_default_platformsettings

in .settings.statSettings.stats

Output

[
  {
    "abbrev": "PA",
    "active": true,
    "apiIdentifier": "passing.passingAttempts",
    "averagable": false,
    "derived": false,
    "description": "Each Pass Attempted",
    "display": true,
    "displayAbbrev": "PA",
    "displayOrder": 7,
    "displaySortReversed": false,
    "gamePlayedMarker": false,
    "id": 0,
    "pointsScoringEligible": true,
    "rotoScoringEligible": false,
    "statCategoryId": 0,
    "statTypeId": 0,
    "strictSlotStatLimit": false
  },
  ...
  {
    "abbrev": "PYPG",
    "active": true,
    "apiIdentifier": "passing.passingYardsPerGame",
    "averagable": false,
    "derived": true,
    "description": "Passing Yards Per Game",
    "display": false,
    "displayAbbrev": "PYPG",
    "displayOrder": 156,
    "displaySortReversed": false,
    "gamePlayedMarker": false,
    "id": 22,
    "pointsScoringEligible": false,
    "rotoScoringEligible": false,
    "statCategoryId": 0,
    "statDerivation": {
      "defaultInvalid": 0.0,
      "derivedFromStats": {
        "a": 3,
        "b": 210
      },
      "equation": "a / b",
      "invalidStatCheck": null,
      "secondaryDefaultInvalid": null
    },
    "statTypeId": 0,
    "strictSlotStatLimit": false
  },
  ...
]

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

Hi @nntrn, I'm just coming back to this now and I'm struggling to find the 'yardsAfterCatch' field in the play-by-play, even using the URL you've provided. It was definitely there when I first accessed it so confused as to why its seemingly different now.

Any ideas on what might be happening here?

Cannot Tell if Picks are made for College Pick 'em or Pigskin Pick 'em Current Week via ESPN Pick'em API

Problem Summary

I'm using ESPN's Pick'em API to track user picks for challenges like NFL Pigskin Pick'em and College Football Pick'em.

The core issue:
I need to know, each week, whether a user has made their picks before the games start. However, the way the API is structured makes this difficult once the season has started.

---

Current Behavior

• Before Week 1:

  • If .picks doesn’t exist: The user hasn’t made any picks.
  • If .picks exists but is empty: The user has submitted picks, but the pick data isn’t available until the games start.

• After Week 1 & Throughout the Season:

  • The .picks array is a flat list with all picks for the season added as games begin.
  • There’s no breakdown by week (no .picks.week2, .picks.week3, etc.).
  • For example:
    • Just before Week 2, .picks for everyone has 16 entries from Week 1.
    • There are no empty or null entries for future weeks.
    • As Week 2 games start, new picks are revealed, and the array grows (17, 18, 19, ...).
    • There's no way to tell ahead of time if someone has made their picks for the upcoming week; you only find out after kickoff, when it’s too late for users to make the picks for the week.

---

Ideal vs. Actual Data Structure

Ideal structure (week-by-week distinction):

{
  "picks": {
    "week1": [...],
    "week2": [...],
    // etc.
  }
}

Actual structure (flat array, no week info):

{
  "picks": [
    {...}, // week 1
    {...}, // week 1
    // ... (only fills as games start, no separation by week)
  ]
}

---

API URLs

• College Football Pick'em:
  https://gambit-api.fantasy.espn.com/apis/v1/challenges/college-football-pickem-2025/entries/{user_guid}
• NFL Pigskin Pick'em:
  https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-pigskin-pickem-2025/entries/{user_guid}

---

What I Want

Is there any way, using the current ESPN Pick'em API, to determine before kickoff whether a user has or hasn't made their picks for a given week during the season?

• Right now, I can only detect an empty/null picks list at the very start of the season (before Week 1).
• After that, the .picks array grows each week, and there's no way to distinguish “not made picks for this week yet” from simply “picks for this week aren’t public yet”—until it’s already too late.

Before the pick ems site redesign a few years ago, ESPN provided this information. If you viewed a person's picks entry, it would say "Chuck has not made their picks yet", but this functionality was removed in the redesign

---

Question

Is this a current limitation of the API, or is there a workaround to detect per-week pick completion before games start?

---

Thank you!

Is there a way to get Men's and Women's College Basketball week data? For example, https://site.api.espn.com/apis/common/v3/sports/football/college-football/seasons?startingseason=2023 will give me a weeks array with the number and their start and end date. However, https://site.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/seasons?startingseason=2023 does not give me any of that data.

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!

I don't know of any official list but just discovered there's a "STATUS_DELAYED" from the Panther / Jags game with a weather delay right now!

@JimNayzium

For college football, is there a way to get stats per week per division? For example, for FBS I want to see the passing yards leader, touchdown leader, sack leader, etc etc.

anyone know how i could pull play by play info by player?

I have a script that knows my yahoo player ID, i want to pull their latest play and have it display, similar to yahoos gamelog when viewing your matchup.