Home
/
REST API Reference
/
Teams
/
Retrieve a team

Retrieve a team

You can fetch the details of a single team, containing an array of admins that belong to this team.

SecurityHTTP: bearerAuth
Request
path Parameters
id
required
string

The unique identifier of a given team.

Example: 123
header Parameters
Intercom-Version
string (intercom_version)
Default: 2.11

Intercom API version.
By default, it's equal to the version set in the app package.

Enum: "1.0" "1.1" "1.2" "1.3" "1.4" "2.0" "2.1" "2.2" "2.3" "2.4" "2.5" "2.6" "2.7" "2.8" "2.9" "2.10" "2.11" "Unstable"
Example: 2.11
get
/teams/{id}
Request samples
Responses
200
successful
Response Schema: application/json
type
string 
Value is always "team"
 
id
string 
The id of the team
 
name
string 
The name of the team
 
admin_ids
Array of integers 
The list of admin IDs that are a part of the team.
 
object or null (Admin Priority Level)  
Admin priority levels for the team
 
401
Unauthorized
404
Team not found
Response samples
application/json
{
"type": "team",
"id": "991271886",
"name": "team 1",
"admin_ids": [ ]
}