Groups

Read-only. Returns all groups except internal system groups.

Required scope: read:groups

Endpoints

GET
/api/open/v1/groups

List groups (paginated). Filter: ?type=department|profession|custom

GET
/api/open/v1/groups/{id}

Get a single group

List groups

curl "https://customer.monotree.com/api/open/v1/groups?type=department" \
  -H "Authorization: Bearer mono_your_token_here"
Query paramNotes
typeOne of department, profession, custom.
page, per_page, sinceStandard pagination.

Response

{
  "data": {
    "id": 1,
    "name": "Kitchen Staff",
    "type": "department",
    "managers": [
      { "id": 42, "name": "John Doe" }
    ],
    "created_at": "2026-01-15T10:00:00+00:00"
  }
}

Field notes

  • managers lists the users flagged as manager of the group. It appears on the /groups endpoints only — not when groups are embedded elsewhere (e.g. on a user).
  • Group types: department (organizational/location unit), profession (job title equivalent, synced from the HR system), custom (free-form).