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

# List Users

`GET /users`

Browse through all the users in your workspace. Filter by organization to see who belongs to specific teams or companies. Results are paginated for easy navigation through large user bases.

## Query parameters

- `limit` number — Maximum number of results to return.
- `offset` number — Offset for pagination.
- `page` number — Page number (used to derive offset = (page-1)*limit).
- `organizationId` string, uuid — Filter users by organization ID.

## Response `200`

Users retrieved successfully

- Participant[] — Array of users.
  - `id` string, required — The Greenflash participant ID.
  - `externalId` string, required — Your external user ID (matches the externalUserId from the request).
  - `organizationId` string, uuid, nullable, required — The internal organization ID that the user belongs to.
  - `externalOrganizationId` string, nullable, required — Your external identifier for the user's organization.
  - `name` string — The participant's full name.
  - `email` string — The participant's email address.
  - `phone` string — The participant's phone number.
  - `anonymized` boolean, required — Whether the participant's personal information is anonymized.
  - `properties` object, required — Additional data about the participant.
  - `createdAt` string, date-time — When the participant was first created.
  - `updatedAt` string, date-time — When the participant was last updated.

## Other responses

- `400` — Bad request

## Changes

- **2025-11-24** `c1998d918478` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/changes/users/get.md)

---

[API](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference.md) · [All operations](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenflash-ai/greenflash-api-reference/revisions/c566e560677d/schema)