Team

A team is a NFL franchise of specific season. The team's players, staff and statistics are related to the team but not what constitutes a team.

This service will allow you to create, update and query for teams.

NOTE: Limited query support at launch. Below is are the supported query signatures. Anything different will result in an error response:

Use Case Supported queries
Teams /teams?s={"$query":{"season":2015},"$take":40}&fs={id,season,fullName,nickName,abbr,teamType,conference{abbr},division{abbr}}
Standings /teams?s={"$query":{"abbr":"SEA","season":2015,"standings":{"$query":{"week.seasonType":"REG"}},"$takeLast":1},"$take":40}&fs={id,season,fullName,nickName,cityStateRegion,abbr,teamType,conference{abbr},division{abbr},standings{overallWins,overallWinPct,overallLosses,divisionWins,divisionLosses,clinchDivision,clinchDivisionAndHomefield,clinchWildcard,clinchPlayoff,conferenceRank,divisionRank}}
Top offense PRE season /teams?s={"$query":{"season":2015},"$sort":{"preTeamSeasonStats.teamStats.totalPointScore":1}}&fs={id,season,fullName,nickName,cityStateRegion,abbr,teamType,conference{abbr},division{abbr},preTeamSeasonStats{teamStats{teamStat{totalTouchdowns},passing{netYards},rushing{yards}}}}
Top defense PRE season /teams?s={"$query":{"season":2015},"$sort":{"preTeamSeasonStats.opponentStats.totalPointScore":1}}&fs={id,season,fullName,nickName,cityStateRegion,abbr,teamType,conference{abbr},division{abbr},preTeamSeasonStats{opponentStats{teamStat{totalTouchdowns},passing{netYards},rushing{yards}}}}
Top offense REG season /teams?s={"$query":{"season":2015},"$sort":{"regTeamSeasonStats.teamStats.totalPointScore":1}}&fs={id,season,fullName,nickName,cityStateRegion,abbr,teamType,conference{abbr},division{abbr},regTeamSeasonStats{teamStats{teamStat{totalTouchdowns},passing{netYards},rushing{yards}}}}
Top defense REG season /teams?s={"$query":{"season":2015},"$sort":{"regTeamSeasonStats.opponentStats.totalPointScore":1}}&fs={id,season,fullName,nickName,cityStateRegion,abbr,teamType,conference{abbr},division{abbr},regTeamSeasonStats{opponentStats{teamStat{totalTouchdowns},passing{netYards},rushing{yards}}}}
Top offense POST season /teams?s={"$query":{"season":2015},"$sort":{"postTeamSeasonStats.teamStats.totalPointScore":1}}&fs={id,season,fullName,nickName,cityStateRegion,abbr,teamType,conference{abbr},division{abbr},postTeamSeasonStats{teamStats{teamStat{totalTouchdowns},passing{netYards},rushing{yards}}}}
Top defense POST season /teams?s={"$query":{"season":2015},"$sort":{"postTeamSeasonStats.opponentStats.totalPointScore":1}}&fs={id,season,fullName,nickName,cityStateRegion,abbr,teamType,conference{abbr},division{abbr},postTeamSeasonStats{opponentStats{teamStat{totalTouchdowns},passing{netYards},rushing{yards}}}}
Team drafts /teams/10044900-2014-de93-fafa-be17820d8386?fs={id,season,fullName,nickName,abbr,cityStateRegion,conference{abbr},division{abbr},draftPicks{round,pickInRound,numberOverall,grade,overView,analysis,personal,nflComparison,bottomLine,draftProjection,profileAuthor,proDayResults,year,relatedContent{title,url},person{id,firstName,lastName,player{position}}},draftNeeds}

"$query":{"abbr":"SEA"} - is optional parameter

Retrieve a team

GET HTTP /teams/{team-id} GET HTTP /teams

Fields

Name Default Type Description
id * uuid unique identifier
type enum Type Domain type
lastModifiedDate DateTime
season * integer Teams are described by their season, or the year in which they existed.
fullName * string The team's long format name. ex. "Indianapolis Colts"_
nickName * string The team's nickname. ex. "Colts"
abbr * string The team's official two or three-letter abbreviation commonly used to fit displays like a scoreboard.,ex. "IND"_
cityStateRegion * string The location where the team calls home, which can be a city, a state or a region
teamType * enum TeamType Is it a regular team or a special pro bowl team
conference Conference The conference the team belongs to
division Division The division the team belongs to
branding Branding Official team branding holder for assets like logos and colors.
venue Venue The team's home venue
roster Collection Person All the players on the team
standings Collection Standings Team's standing for this season
preTeamSeasonStats TeamSeasonStats Preseason teamSeasonStats
regTeamSeasonStats TeamSeasonStats Regular Season teamSeasonStats
postTeamSeasonStats TeamSeasonStats Post season teamSeasonStats
teamGameStats Collection TeamGameStats All team game stats for this season
injuries Collection Injury All team's injury players
depthChart Depth Chart Depth Chart
webdomain string Domain name of team's primary web address. ex. "www.colts.com"
rivals Collection Team This team's rivals
established integer The year the franchise was established. ex. 1953
status enum Does the team play in current season?
remainingOpponentsString string List of remaining opponents
draftPicks Collection DraftPick List of draft picks
draftNeeds Collection DraftNeed List of needed drafts

Default Sorting Field

index Default Sorting Field Default Ordering
1 fullName ASC
2 season DESC

TeamType - Enum

Value Description
TEAM a normal team
PRO pro bowl team

Schema Instance

Team JSON

Usage Examples

Team Profile

Standings