Get list of groups
GET
https://example.kaiten.ru/api/latest/company/groupsGet groups list filtered by query params. Use limit and offset to paginate results when with_tree_entities is false.
Starting from 2026-11-01, this route uses a default and maximum limit of 100 and validates limit and offset. with_tree_entities=true returns 400. Use GET /company/groups/{group_uid}/entities with limit and offset instead.
| Name | Type | Constraints | Description |
|---|---|---|---|
| with_tree_entities | boolean | Add tree entities for each group. Unavailable from 2026-11-01. | |
| with_users_count | boolean | Add users count for each group | |
| with_sync_group_attribute | boolean | Add sync attribute for each group | |
| condition | enum | 1 - active, 2 - inactive | |
| query | string | Search query | |
| limit | integer | Default: 100 Max: 100 | Maximum amount of records |
| offset | integer | Number of records to skip |
Responses
| Description | Response type | Example |
|---|---|---|
| Success | Array of objects |
| Name | Type | Description |
|---|---|---|
| name | string | Group name |
| permissions | integer | Group permissions |
| updated | string | Last update timestamp |
| created | string | Create date |
| id | integer | Group id |
| uid | string | Group uid |
| add_to_cards_and_spaces_enabled | boolean | Ability to add all users of the group to cards, placed in group spaces. Ability to filter logs by group in «Timesheets» |
| Description | Response type | Example |
|---|---|---|
| Invalid pagination parameters or prohibited query parameter | Response body does not exist |
| Description | Response type | Example |
|---|---|---|
| Invalid token | String |
| Description | Response type | Example |
|---|---|---|
| Forbiden | Response body does not exist |
| Description | Response type | Example |
|---|---|---|
| Not found | Response body does not exist |
Kaiten
If you have any questions or need help with integration feel free to write us at support@kaiten.ru
1 curl --request GET \
2 --url 'https://example.kaiten.ru/api/latest/company/groups' \
3 --header 'Accept: application/json' \
4 --header 'Content-Type: application/json'
5 Response
ClickTry It!to start a request and see the response here!