---
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, unless both users share an external team (synced via OIDC/LDAP), in which case they can always find each other.

## Query parameters

- `s` string

## Response `200`

All (found) users.

- UserUser[]
  - `bot_owner_id` integer — BotOwnerID is the ID of the owning (human) user if this user is a bot. A non-zero value means this user is a bot and cannot authenticate via password.
  - `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.net/go-vikunja/apis/vikunja-api.md) · [All operations](https://skmtc.net/go-vikunja/apis/vikunja-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/go-vikunja/vikunja-api/revisions/feb3f68bbdf1/schema)