---
title: "List users in your organisation"
method: GET
path: "/users"
tags: ["Organisation"]
---

# List users in your organisation

`GET /users`

Returns all users in the organisation of the authenticated API credential. Requires a credential with the `manage-organisation` capability, granted to organisation administrators.

## Response `200`

Returns the list of users in your organisation

- UsersResponse
  - `users` User[], required
    - `updated-at` string
    - `email` string
    - `last-name` string
    - `timezone` string
    - `roles` string[] — Role names held by the user
    - `company-role` string — Free-text job title
    - `first-name` string
    - `id` string, uuid, required
    - `activated` boolean
    - `created-at` string

---

[API](https://skmtc.net/signal-ai/apis/signal-ai-api.md) · [All operations](https://skmtc.net/signal-ai/apis/signal-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signal-ai/signal-ai-api/revisions/0ab7ff186291/schema)