---
title: "List Users"
method: GET
path: "/v1/user/"
---

# List Users

`GET /v1/user/`

API to list cursor-based paginated list of users in your workspace.

Pass the optional `tenant_id` query parameter to list only users associated with that tenant. When the filter is applied, each user object in the response also carries a `tenant` block containing the tenant-scoped property and channel overrides for that user.

## Query parameters

- `tenant_id` string

## Response `200`

200

- object
  - `meta` object — Metadata related to pagination.
    - `count` integer — Total number of records available.
    - `limit` integer — Maximum number of records per page.
    - `has_prev` boolean — Indicates if there is a previous page.
    - `before` string, nullable — Cursor for the previous page.
    - `has_next` boolean — Indicates if there is a next page.
    - `after` string — Cursor for the next page.
  - `results` object[] — List of users objects
    - `distinct_id` string — Unique identifier of the user.
    - `properties` object — User properties (simplified)
    - `created_at` string, date-time — Timestamp when the user was created.
    - `updated_at` string, date-time — Timestamp when the user was last updated.

---

[API](https://skmtc.net/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.net/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/versions/8bd2574bd2c3/schema)