Teams Reference

While you can migrate from v3 to v5, know that v5 is deprecated and will be shutdown in the future. We prefer that you migrated directly to the new Twitch API.

Endpoint	Description
Get All Teams	Gets all active teams.
Get Team	Gets a specified team object.

Get All Teams

✎

Gets all active teams.

Authentication

None

URL

GET https://api.twitch.tv/kraken/teams

Optional Query String Parameters

Name	Type	Description
`limit`	integer	Maximum number of objects to return, sorted by creation date. Default: 25. Maximum: 100.
`offset`	integer	Object offset for pagination of results. Default: 0.

Example Request

This gets the team objects for the 25 most recently created teams.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-X GET 'https://api.twitch.tv/kraken/teams'

Example Response

{
   "teams": [{
      "_id": 10,
      "background": null,
      "banner": "https://static-cdn.jtvnw.net/jtv_user_pictures/team-staff-banner_image-606ff5977f7dc36e-640x125.png",
      "created_at": "2011-10-25T23:55:47Z",
      "display_name": "Twitch Staff",
      "info": "Twitch staff stream here. Drop in and say \"hi\" sometime :)",
      "logo": "https://static-cdn.jtvnw.net/jtv_user_pictures/team-staff-team_logo_image-76418c0c93a9d48b-300x300.png",
      "name": "staff",
      "updated_at": "2014-10-16T00:44:11Z"
   },
   ...
   ]
}

Get Team

✎

Gets a specified team object.

Authentication

None

URL

GET https://api.twitch.tv/kraken/teams/

Optional Query String Parameters

None

Example Request

This gets the staff team.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-X GET 'https://api.twitch.tv/kraken/teams/staff'

Example Response

{
   "_id": 10,
   "background": null,
   "banner": "https://static-cdn.jtvnw.net/jtv_user_pictures/team-staff-banner_image-606ff5977f7dc36e-640x125.png",
   "created_at": "2011-10-25T23:55:47Z",
   "display_name": "Twitch Staff",
   "info": "Twitch staff stream here. Drop in and say \"hi\" some time :)",
   "logo": "https://static-cdn.jtvnw.net/jtv_user_pictures/team-staff-team_logo_image-76418c0c93a9d48b-300x300.png",
   "name": "staff",
   "updated_at": "2014-10-16T00:44:11Z",
   "users": [{
         "_id": 5582097,
         "broadcaster_language": "en",
         "created_at": "2009-04-13T21:22:28Z",
         "display_name": "Sarbandia",
         "followers": 1182,
         "game": "Hearthstone: Heroes of Warcraft",
         "language": "en",
         "logo": "https://static-cdn.jtvnw.net/jtv_user_pictures/sarbandia-profile_image-6693b5952f31c847-300x300.jpeg",
         "mature": false,
         "name": "sarbandia",
         "partner": false,
         "profile_banner": "https://static-cdn.jtvnw.net/jtv_user_pictures/sarbandia-profile_banner-247cdbe62dbcf4d9-480.jpeg",
         "profile_banner_background_color": null,
         "status": "Midrange shaman laddering",
         "updated_at": "2016-12-15T19:02:40Z",
         "url": "https://www.twitch.tv/sarbandia",
         "video_banner": null,
         "views": 8168
   },
   ...
   ]
}