Users

Read-only. Returns only registered users — those who have accepted an invite. Pending invitations and deactivated accounts are not returned.

Required scope: read:users

Endpoints

GET

/api/open/v1/users

List registered users (paginated). Filters: ?group_id={id}, ?since={date}

GET

/api/open/v1/users/{id}

Get a single user

List users

curl "https://customer.monotree.com/api/open/v1/users?group_id=1&per_page=25" \
  -H "Authorization: Bearer mono_your_token_here"

Query param	Notes
`group_id`	Filter users that belong to this group.
`page`, `per_page`, `since`	Standard pagination — see Pagination.

Response

{
  "data": {
    "id": 42,
    "name": "John Doe",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "type": "default",
    "avatar_url": "https://images.monotree.com/avatars/john-doe.jpg",
    "is_manager": false,
    "groups": [
      { "id": 1, "name": "Kitchen Staff", "type": "department", "is_manager": false, "created_at": "2026-01-15T10:00:00+00:00" }
    ],
    "hired_at": "2025-06-01",
    "date_of_birth": "1994-08-12",
    "is_away": false,
    "last_active_on": "2026-03-22T14:05:12.000000Z",
    "registered_at": "2025-06-01T09:00:00+00:00",
    "created_at": "2025-06-01T09:00:00+00:00"
  }
}

Field notes

hired_at is the effective hire date: a manual override set in the CMS wins over the synced value.
date_of_birth is null unless the customer collects it (e.g. via an onboarding field).
There is no dedicated job title field. A user's profession group(s) serve that role: filter groups[] by type profession (synced from the HR system's position/job title). Departments (type department) are the organizational/location unit; a user can belong to several.
is_manager (top level) is true when the user manages at least one group. The is_manager flag on each groups[] entry tells which ones. To resolve an employee's manager(s), fetch the managers of their department group(s) via Groups.