Get members
Get members of an organization user group. This endpoint returns a paginated list of users who are members of the specified group.
GET https://api.tedee.com/api/v37/organization/{organizationId}/user-groups/{groupId}/members?page={page}&itemsPerPage={itemsPerPage}&filters.text={text}
URI Parameters
Name |
Type |
Description |
---|---|---|
filters.text |
string (optional) |
Filter by name or email |
groupId |
UUID |
id of user group |
itemsPerPage |
number (optional) |
Items per page (max: 100, min: 1) |
organizationId |
number |
id of organization |
page |
number (optional) |
Page number (min: 1) |
Responses
Name |
Type |
Description |
---|---|---|
200 OK |
successful operation |
Scopes
Name |
Description |
---|---|
Organization.Read |
Grants user possibility to read organization data |
Organization.ReadWrite |
Grants user possibility to read and write organization data |
Examples
Get all group members
Sample Request
curl -X GET "https://api.tedee.com/api/v37/organization/1/user-groups/a4d5e6f7-8b9c-4d2e-9f1a-3b4c5d6e7f8a/members" -H "accept: application/json" -H "Authorization: Bearer <<access token>>"
Sample response
HTTP status code: 200
{
"result": {
"items": [
{
"displayName": "John Doe",
"email": "[email protected]",
"organizationUserId": 11
},
{
"displayName": "Jane Smith",
"email": "[email protected]",
"organizationUserId": 12
},
{
"displayName": "Bob Wilson",
"email": "[email protected]",
"organizationUserId": 13
}
],
"totalCount": 3
},
"errorMessages": [],
"statusCode": 200,
"success": true
}
Search for specific members
Sample Request
curl -X GET "https://api.tedee.com/api/v37/organization/1/user-groups/a4d5e6f7-8b9c-4d2e-9f1a-3b4c5d6e7f8a/members?filters.text=john" -H "accept: application/json" -H "Authorization: Bearer <<access token>>"
Sample response
HTTP status code: 200
{
"result": {
"items": [
{
"displayName": "John Doe",
"email": "[email protected]",
"organizationUserId": 11
}
],
"totalCount": 1
},
"errorMessages": [],
"statusCode": 200,
"success": true
}