---
title: "Get users"
method: GET
path: "/users"
tags: ["user"]
---

# Get users

`GET /users`

Search for a user by its username, name or full email. Name (not username) or email require that the user has enabled this in their settings.

## Query parameters

- `s` string

## Response `200`

All (found) users.

- UserUser[]
  - `created` string — A timestamp when this task was created. You cannot change this value.
  - `email` string — The user's email address.
  - `id` integer — The unique, numeric id of this user.
  - `name` string — The full name of the user.
  - `updated` string — A timestamp when this task was last updated. You cannot change this value.
  - `username` string — The username of the user. Is always unique.

## Other responses

- `400` — Something's invalid.
- `500` — Internal server error.

---

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