List Users for a Team
Returns a paginated list of all users who are members of the specified team.
Endpoint
GET
v5/accountteams/{team_id}/users
Requires authentication
Path Parameters
The team whose members will be retrieved.
team_id
string
required
The ID of the team whose users will be listed.
Query Parameters
This endpoint does not accept additional query parameters beyond authentication credentials.
None
Response
Returns a paginated array of user-team objects for the members of the specified team.
result_ok
boolean
Whether the request succeeded.
total_count
integer
Total number of users matching the request.
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 user-team objects.
child attributes
user_id
string
The ID of the user.
username
string
The username or display name of the user.
email
string
The email address of the user.
team_id
string
The ID of the team.
team_name
string
The name of the team.
is_team_manager
boolean
Whether the user is a manager of this team.
role_id
string
The ID of the user's role on this team.
role_name
string
The name of the user's role on this team.
Examples
Request (cURL)
curl -X GET "https://api.alchemer.com/v5/accountteams/YOUR_TEAM_ID/users?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"total_count": 2,
"page": 1,
"total_pages": 1,
"results_per_page": 2,
"data": [
{
"user_id": "YOUR_USER_ID",
"username": "Jane Smith",
"email": "jane.smith@example.com",
"team_id": "YOUR_TEAM_ID",
"team_name": "Example Team",
"is_team_manager": false,
"role_id": "4",
"role_name": "Editor"
},
{
"user_id": "YOUR_USER_ID_2",
"username": "John Doe",
"email": "john.doe@example.com",
"team_id": "YOUR_TEAM_ID",
"team_name": "Example Team",
"is_team_manager": false,
"role_id": "4",
"role_name": "Editor"
}
]
}