---
title: "Get users"
method: GET
path: "/public/v1/users"
tags: ["User"]
---

# Get users

`GET /public/v1/users`

Get a paginated list of the team members (users) in your company, sorted oldest-first by their creation datetime.

Use this to enumerate everyone on your team along with their email, role, and full name, or to keep an external system in sync with your Distru user list. Results are always scoped to your own company; users in other companies are never returned. By default soft-deleted users are excluded — use the `deleted` filter to include or isolate them.

This is a read-only endpoint and does not change anything in the system. Its data is eventually consistent: a user that was just created, modified, or deleted may take up to ~1 second to appear or reflect the change here.

The response is an envelope of `{ data: [...], next_page: ... }`. Up to 1000 users are returned per page; when more pages remain, `next_page` is a ready-to-follow URL for the next page, and it is null on the last page.

Required permission: `settings_permissions_manage_team`.

## Query parameters

- `ids` string[]
- `inserted_datetime` string
- `deleted` 'no' | 'include' | 'only'
- `page` string
- `updated_datetime` string

## Response `200`

A list of users

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission

---

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