v2

latestOpenAPI 3.1.12026-07-2613060964.2 KB

List Users

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.

get/v1/user/

Query parameters

tenant_idstring

Filter users associated with the given tenant. When set, each result includes the tenant-scoped properties and channel overrides applied for this user under that tenant.

Response

200

Example response

{
  "meta": {
    "count": 1201709,
    "limit": 10,
    "has_next": true,
    "after": "01JXXXX99APxxxxxx8Wxxxx1B"
  },
  "results": [
    {
      "distinct_id": "_distinct_id_",
      "created_at": "2025-04-04T21:37:36.712496+00:00",
      "updated_at": "2025-04-04T21:37:36.743167+00:00"
    }
  ]
}