---
title: "List all users"
method: GET
path: "/users"
tags: ["Users"]
---

# List all users

`GET /users`

List all users

## Query parameters

- `fields` string
- `skip` number
- `limit` number
- `sort` string
- `q` string

## Response `200`

Successful response

- object
  - `count` number, required
  - `fields` string, required
  - `sort` string, required
  - `skip` number, required
  - `limit` number, required
  - `results` object[], required
    - `_id` string — User MongoDB _id
    - `accountId` string — Your account ID
    - `email` string
    - `emails` string[]
    - `firstName` string
    - `userStartedUpdateEmailFlow` boolean
    - `lastName` string
    - `fullName` string
    - `title` string
    - `timezone` string
    - `picture` object
      - `thumbnail` string, required
      - `regular` string, required
      - `large` string, required
    - `tags` string[]
    - `lastActivityTime` number
    - `phone` string
    - `phones` string[]
    - `preferredContactMethod` string
    - `noteBeforeContacting` string
    - `notes` string
    - `favs` object
      - `views` string[], required
    - `displayLanguage` string
    - `settings` object
      - `notifications` object — Notification settings
        - `subscriptions` object[], required
          - `type` 'PAYMENT' | 'RESERVATION' | 'TASK' | 'GENERAL' | 'NIGHTS_LIMIT' | 'PROPERTY', required
          - `name` string, required
          - `targets` string[], required
    - `roles` object[] — Deprecated: Roles field is optional and may not be present for users created in the new flow.
      - `roleId` string, required — Role ID: * `58db6932ea2a13ea9f4855a5` - Account manager * `578b52a6dddfe2b1d0781b0e` - Listing Viewer * `578b52a6dddfe2b1d0781b0f` - Calendar Availability Control * `578b52a6dddfe2b1d0781b12` - Listing Admin * `578b52a6dddfe2b1d0781b10` - Calendar Full Control * `578b52a6dddfe2b1d0781b11` - Listing's Financials * `57447a900ebc04ba98064035` - Account admin * `57c2d040cf6c3fed6a4d1775` - Integration Manager * `58db693fea2a13ea9f4855aa` - Viewer * `579e1769cf6c3fed6a3f6b1a` - Listing Manager * `5e567a850ba1fb0244146fc0` - Calendar Viewer * `5e57b0826b4440002a603a93` - Communication Agent * `60d1b0fb396b25993e756e63` - Revenue Manager
      - `listingIds` string[]

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/revisions/7c62644070f2/schema)