• Overview
• Using the API
• Parameters
• What it Returns

• The ESPN Standings API enables you to get the latest standings for a particular sport by division, conference, or overall. Data is also available by year and by season type (preseason, regular season, playoffs).

  This API is currently a version 1 (/v1/) release.

  Availability
  Public	Strategic Partner	ESPN

• The ESPN Standings API accepts a GET request.

  The format of an API request is as follows:
  api.espn.com/:version/:resource/:method?apikey=:yourkey

  Sample Standings Requests

  Action	URI	Description
  GET	api.espn.com/v1/sports/baseball/mlb/standings	Latest standings for Major League Baseball, grouped by division.
  GET	api.espn.com/v1/sports/baseball/mlb/standings?lang=es	Latest standings for Major League Baseball, grouped by division, with optional Spanish-language translations enabled.
  GET	api.espn.com/v1/sports/baseball/mlb/standings?dates=2009	MLB standings for a particular season.
  GET	api.espn.com/v1/sports/baseball/mlb/standings?groups=2	Standings for the American League East division in MLB for the current season.
  GET	api.espn.com/v1/sports/baseball/mlb/standings?groups=2&dates=2010	Standings for the American League East division in MLB in the 2010 season.
  GET	api.espn.com/v1/sports/baseball/mlb/standings?seasontype=3	Returns postseason standings for all MLB teams playing in the playoffs.

• Quick Navigation

  • Resources
  • Methods
  • URI Parameters

  Resources

  Resource Name	Description	Availability
  		public	strategic partner	espn
  /sports/baseball/mlb	Major League Baseball (MLB)
  /sports/basketball/mens-college-basketball	NCAA Men's College Basketball
  /sports/basketball/nba	National Basketball Association (NBA)
  /sports/basketball/wnba	Women's National Basketball Association (WNBA)
  /sports/basketball/womens-college-basketball	NCAA Women's College Basketball
  /sports/football/college-football	NCAA College Football
  /sports/football/nfl	National Football League (NFL)
  /sports/golf/pga	Professional Golfers' Association (PGA) golf
  /sports/hockey/nhl	National Hockey League (NHL)
  /sports/racing/f1	Formula 1 Racing
  /sports/racing/irl	IndyCar Series Racing
  /sports/racing/sprint	NASCAR Sprint Racing
  /sports/racing/truck	NASCAR Truck Racing
  /sports/soccer/:leagueAbbrev	Specific professional soccer league. Use a helper API call for a complete list of supported soccer leagues.
  /sports/tennis/atp	Association of Tennis Professionals
  /sports/tennis/wta	Women's Tennis Association

  Back to top

   

  Methods

  Method	Description	Availability
  		public	strategic partner	espn
  /standings	Retrieves a list of ranked competitors with corresponding API links.

  Back to top

   

  URI Parameters

  Method	Description	Availability
  		public	strategic partner	espn
  enable	Optional flag to enable specific information, with the following options. Accepts a single value or a comma delimited string of values (i.e. enable=a,b,c).
  	logos Enables team logos.
  dates	Integer in the form of yyyy to limit output to a particular season. If not explicitly passed will default to the current season and season type (pre/reg/post) corresponding to the current date.
  seasontype	Value corresponding to either preseason, regular season, or postseason games. Accepts string (pre/reg/post) values. If not explicitly passed will default to the season type corresponding to the current date. This parameter is not applicable to golf, tennis, or racing.
  flat	Boolean (default is false) - Returns a flattened result set in order to show all teams ranked from first to last without breaking them out into divisions. Only valid with team-based sports.
  groups	Integer - Allows for filtering by "group" or division, e.g. AL East, NFC South, etc. For group IDs and their corresponding values, make a request to developer.espn.com/v1/:sportname/:leaguename/groups. Not applicable to golf and tennis.
  type	String - allows further refinement in a specific sport. Possible values are as follows per sport:
  	mlb wildcard
  	racing points / poles / top10s / top5s / money / wins / cars
  	golf points / money / wins / top10s
  	tennis race / rank / money
  lang	Can be used to return content in the specified language. Supported languages are below. Note: not all content is available in multiple languages and will return in English if no alternative is available.
  	en English. Default language.
  	es Spanish

  Back to top

   

• Quick Navigation

  • Returned Data
  • Sample Response

  Returned Data

  Element	Description	Availability
  		public	strategic partner	espn
  sports	A collection of sports associated with the request, e.g. "baseball." Contains a leagues collection and also has the following properties:
  	name The name of the sport, e.g. "Baseball."
  	id the ID of the sport in the ESPN API.
  	uid A globally unique string identifier for the sports entity in ESPN's systems.
  	type String - the type of standings view for the current request. Defaults to "points" for a standard standings view. Additional standings types vary by sport and are documented in the URI parameters documented for this API.
  leagues	Collection within 'sports' that contains a 'group' collection and also the following properties:
  	id the ID of the sport in ESPN's meta-tagging system.
  	uid A globally unique string identifier for the sports entity in ESPN's systems.
  	groupId The ID, unique to the selected organizing body, of the conference/division being used.
  	name the name of the league/conference/division, e.g. "American League East."
  	shortName Shorter version of the name of the league/conference/division.
  	abbreviation the abbreviation for the league/conference/division, e.g. "al" for "American League."
  groups	Collection of group objects within 'leagues'. May also contain child groups of the same type. Contains a collection of 'competitors'. Also contains all the properties below:
  	id the id corresponding to the league/conference/division.
  	name the name of the league/conference/division, e.g. "American League West."
  	abbreviation the abbreviation for the league/conference/division, e.g. "alw" for "American League West."
  competitors	Collection of teams or athletes (depending on sport) within the 'group' collection. Contains the following properties:
  id	The team's ID within that sport.
  location	The team's location, e.g. "New York."
  name	The team's nickname, e.g. "Yankees."
  abbreviation	The team's abbreviation, e.g. "nyy."
  logos	Collection of team logos as specified below, each containing href, width, and height attributes:
  	large 110x110 team logo
  	medium 80x80 team logo
  	small 50x50 team logo
  	xsmall 40x40 team logo
  	xxsmall 25x25 team logo
  record	A collection within the competitor object with record summary, season info, and stats views for different splits, including season, conference, division, home, away, and stats. Details of each record object are below.
  	season Object containing the following properties:
  	year - the calendar year in which the majority of the sport's season is played.
  	type - Integer corresponding to the season type (1 = preseason, 2 = regular season, 3 = postseason).
  	description - String representation of the season type (e.g. "regular" for season type = 2).
  	startDate - date for which the season starts for this sport/league.
  	endDate - date for which the season ends for this sport/league.
  	summary A string representation of the team's record, e.g. "75-42".
  	wins Wins for the season specified.
  	losses Losses for the season specified.
  	ties Ties for the season specified (where applicable).
  	overTimeLosses Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
  	winPercentage Win percentage based on wins/losses.
  	conference Object within the 'record' object containing statistics for team against conference opponents during the selected season (default is current year).
  	summary - A string representation of the team's record, e.g. "75-42".
  	wins - Wins for the season specified.
  	losses - Losses for the season specified.
  	ties - Ties for the season specified (where applicable).
  	overTimeLosses - Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
  	winPercentage - Win percentage based on wins/losses.
  	division Object within the 'record' object containing statistics for team against division opponents during the selected season (default is current year).
  	summary - A string representation of the team's record, e.g. "75-42".
  	wins - Wins for the season and year specified.
  	losses - Losses for the season specified.
  	ties - Ties for the season specified (where applicable).
  	overTimeLosses - Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
  	winPercentage - Win percentage based on wins/losses.
  	home Object within the 'record' object containing statistics for team when the team is playing at home during the selected season (default is current year).
  	summary - A string representation of the team's record, e.g. "75-42".
  	wins - Wins for the season and year specified.
  	losses - Losses for the season specified.
  	ties - Ties for the season specified (where applicable).
  	overTimeLosses - Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
  	winPercentage - Win percentage based on wins/losses.
  	away Object within the 'record' object containing statistics for team when the team is playing on the road during the selected season (default is current year).
  	summary - A string representation of the team's record, e.g. "75-42".
  	wins - Wins for the season specified.
  	losses - Losses for the season specified.
  	ties - Ties for the season specified (where applicable).
  	overTimeLosses - Overtime (or extra inning) losses for the season specified. Not applicable to all sports.
  	winPercentage - Win percentage based on wins/losses.
  stats	When enabled, returns an object within the 'competitor' object of additional statistics as shown below:
  	streak Positive or negative number representing the number of consecutive wins or losses.
  	gamesPlayed Total games played.
  	points
  	pointsAgainstTotal Total points scored against the team.
  	pointsAgainstAverage Avg. points scored against the team per game/match.
  	pointsForTotal Total points scored.
  	pointsForAverage Total points score per game/match.
  	playoffSeed The team's current position (seed) if the playoffs began today. Not applicable to all sports.
  	gamesBehind Games behind first place team.
  links	Collection of relevant API endpoints and canonical URLs for the team.

  Back to top

   

  Sample Response

  XML

  The following XML output was rendered with an internal key calling:
  api.espn.com/v1/sports/basketball/nba/standings?seasontype=2&_accept=text/xml&apikey=:yourkey.

   

  JSON

  The following JSON output was rendered with an internal key calling:
  api.espn.com/v1/sports/basketball/nba/standings?seasontype=2&apikey=:yourkey.

  Back to top

• Sample Code

  Coming soon.

Browse Other Data

• Audio
• Athletes
• Calendar
• Draft
• Headlines
• Leaders
• Medals
• Now
• Rankings
• Research Notes
• Scores & Schedules
• Standings
• Teams
• Video
• WatchESPN

Additional Help

• Get Started