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

# List users

`GET /users`

Fetch a list of users. Ratelimit: 5 reqs/min.

## Query parameters

- `page` integer
- `limit` integer
- `query` string

## Response `200`

A paginated list of users

- object
  - `users` User[]
    - `id` integer
    - `slack_id` string
    - `display_name` string
    - `avatar` string
    - `project_ids` integer[]
    - `cookies` integer, nullable
  - `pagination` Pagination
    - `current_page` integer
    - `total_pages` integer
    - `total_count` integer
    - `next_page` integer, nullable

## Other responses

- `400` — Invalid request parameters
- `401` — Missing or invalid API key
- `429` — Rate limit exceeded

## Changes

- **2026-03-26** `5aa899f5a7d4` — 1 info
  - added the non-success response with the status `429`
- **2026-03-26** `69b66574f6f0` — 2 info
  - added the new optional `query` request parameter `limit`
  - added the non-success response with the status `400`
- **2026-02-28** `cf6ee4e9eef4` — 1 warning, 2 info
  - deleted the `query` request parameter `limit`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `429`

[Change history](https://skmtc.dev/hackclub/apis/flavortown-api/changes/users/get.md)

---

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