GoSportsAPIDocs
Sign InGet API Key
American Football / Teams

Get Teams

Retrieve teams with their short code, conference, division and home stadium.

GET/v1/american-football/teams

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
idintegerOptionalFilter by team ID.
league_idintegerOptionalFilter by league ID.
divisionstringOptionalDivision code, e.g. afc-west.
searchstringOptionalSearch by team name (3+ characters).
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Team>
    Teams matching your filters.
  • idinteger
    Unique team ID.
  • namestring
    Team name.
  • codestring
    Short code, e.g. KC.
  • conferencestring
    Conference, e.g. AFC.
  • divisionstring
    Division, e.g. AFC West.
  • venueobject
    Home stadium name and city.
  • metaobject
    page, per_page and total.

Status codes

  • 200Teams returned
  • 400Invalid parameter
  • 401Missing or invalid API key
  • 429Rate limit reached