Teams - Get All Teams

Get a list of all teams.

GET https://dev.azure.com/{organization}/_apis/teams?api-version=5.0-preview.2
GET https://dev.azure.com/{organization}/_apis/teams?$mine={$mine}&$top={$top}&$skip={$skip}&api-version=5.0-preview.2

URI Parameters

Name In Required Type Description
organization
path True
  • string

The name of the Azure DevOps organization.

$mine
query
  • boolean

If true return all the teams requesting user is member, otherwise return all the teams user has read access

$top
query
  • integer
int32

Maximum number of teams to return.

$skip
query
  • integer
int32

Number of teams to skip.

api-version
query True
  • string

Version of the API to use. This should be set to '5.0-preview.2' to use this version of the api.

Responses

Name Type Description
200 OK

successful operation

Examples

Sample Request

GET https://dev.azure.com/fabrikam/_apis/teams?$mine=True&api-version=5.0-preview.2

Sample Response

{
  "value": [
    {
      "id": "564e8204-a90b-4432-883b-d4363c6125ca",
      "name": "Quality assurance",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/564e8204-a90b-4432-883b-d4363c6125ca",
      "description": "Testing staff",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/564e8204-a90b-4432-883b-d4363c6125ca"
    },
    {
      "id": "66df9be7-3586-467b-9c5f-425b29afedfd",
      "name": "Fabrikam-Fiber-TFVC Team",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/66df9be7-3586-467b-9c5f-425b29afedfd",
      "description": "The default project team.",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/66df9be7-3586-467b-9c5f-425b29afedfd"
    }
  ],
  "count": 2
}

Definitions

WebApiTeam

Name Type Description
description
  • string

Team description

id
  • string

Team (Identity) Guid. A Team Foundation ID.

identityUrl
  • string

Identity REST API Url to this team

name
  • string

Team name

projectId
  • string
projectName
  • string
url
  • string

Team REST API Url