Get Account Team
Returns information about a specific team in your account.
Endpoint
GET
v5/accountteams/{team_id}
Requires authentication
Path Parameters
The team to retrieve.
team_id
string
required
The ID of the team to retrieve.
Query Parameters
This endpoint does not accept additional query parameters beyond authentication credentials.
None
Response
Returns a single account team object.
result_ok
boolean
Whether the request succeeded.
count
integer
Number of results returned. Always
1 for this endpoint.page
integer
Current page index. Always
1 for this endpoint.results_per_page
integer
Number of results per page. Always
1 for this endpoint.data
object
The account team object.
child attributes
id
string
The unique ID of the team.
team_name
string
The name of the team.
description
string | null
A description of the team. Returns
null if not set.default_role
integer | null
The ID of the default role assigned to team members. Returns
null if not set.status
string
The status of the team. Possible values:
Active, Deleted.Examples
Note GET requests are cached for 60 seconds. Repeated identical requests within that window will return cached results.
Request (cURL)
curl -X GET "https://api.alchemer.com/v5/accountteams/YOUR_TEAM_ID?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"count": 1,
"page": 1,
"results_per_page": 1,
"data": {
"id": "YOUR_TEAM_ID",
"team_name": "Team 1",
"description": null,
"default_role": null,
"status": "Active"
}
}