List Account Teams
Returns a list of all teams in your account.
Endpoint
GET
v5/accountteams
Requires authentication
Path Parameters
None
Query Parameters
All query parameters are optional.
showdeleted
boolean
When set to
true, includes deleted teams in the results. Defaults to false.Response
Returns a paginated list of account team objects.
result_ok
boolean
Whether the request succeeded.
total_count
integer
Total number of teams in the account.
page
integer
Current page index.
total_pages
integer
Number of available pages.
results_per_page
integer
Number of results returned per page.
data
array
Array of account team objects.
child attributes
id
integer
The unique ID of the team.
team_name
string
The name of the team.
description
string
A description of the team. Empty string if not set.
default_role
integer | string
The ID of the default role assigned to team members. Empty string 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?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"total_count": 3,
"page": 1,
"total_pages": 1,
"results_per_page": 3,
"data": [
{
"id": 389746,
"team_name": "Everyone",
"description": "",
"default_role": "",
"status": "Active"
},
{
"id": 389747,
"team_name": "Team 1",
"description": "",
"default_role": "",
"status": "Active"
},
{
"id": 453837,
"team_name": "Team 2",
"description": "",
"default_role": "",
"status": "Active"
}
]
}