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/
)
- nfl-nerd
- ESPN's hidden API endpoints
- Using ESPN's new Fantasy API (v3)
- ESPN: Get Endpoint (CRAN Package)
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 |
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
-
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
-
Injuries: sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/injuries
-
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
-
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/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",
/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®ion=us"
},
{
"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3049325?lang=en®ion=us"
},
{
"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3915373?lang=en®ion=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,
/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",
/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,
/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": [
{
/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"
}
]
}
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/athletes/athlete_id
/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": [
{
/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"
}
/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
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
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": [
{
/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"
}
},
{
/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"
}
/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"
}
]
}
/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",
/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",
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/drives/drive_id
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
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/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
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,
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/plays/play_id
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"
},
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/probabilities/probabilities_id
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
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
},
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/competitors/competitors_id
/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": {
/v2/sports/football/leagues/nfl/seasons/year
/draft/athletes
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"
/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",
/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"
}
}
/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"
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
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,
/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": [
{
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/groups/group_id
/standings
Results
{
"count": 4,
"pageIndex": 1,
"pageSize": 25,
"pageCount": 1,
"items": [
{
"id": "0",
"name": "overall",
"displayName": "Overall Standings",
"links": [
{
"language": "en-US",
"rel": [
/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"
}
]
}
/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,
/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
},
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/odds/provider_id
/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"
}
},
/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"
},
/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
}
/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,
/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",
/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,
/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"
}
]
}
/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"
/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": {
/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",
/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"
},
/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",
/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": [
/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"
},
/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"
}
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/teams/team_id
/attendance
Results
{
"id": "0",
"name": "Attendance",
"abbreviation": "ATTND",
"categories": [
{
"name": "home",
"displayName": "Home",
"shortDisplayName": "Home",
"abbreviation": "home",
"stats": [
{
"name": "games",
"displayName": "Home Games",
/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": [{}]
}
/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",
/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"
},
/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"
},
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/teams/team_id
/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,
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/teams/team_id
/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",
/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
}
/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,
/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
}
/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",
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/teams/team_id
/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
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",
/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"
}
}
/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"
}
},
/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"
/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",
/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,
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/weeks/weeknum
/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": {
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/weeks/weeknum
/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",
@nntrn Thanks you for this. I'll take a look at it when the season starts. It might only show the picks they made after the game starts tho.
What I'm trying to solve for is knowing if a user has made their picks for the week before kickoff. Before the site redesign a few years ago, you used to be able to view a person's profile and it'd say something like "User X has not submitted their picks for this week". Now that message isn't shown. We have a lot of people in our group that forget to make their picks and miss out.