---
title: "Get users"
method: GET
path: "/api/v2/users"
tags: ["Users"]
---

# Get users

`GET /api/v2/users`

## Query parameters

- `q` string
- `after_id` string, uuid
- `limit` integer
- `offset` integer

## Response `200`

OK

- CodersdkGetUsersResponse
  - `count` integer
  - `users` CodersdkUser[]
    - `avatar_url` string, uri
    - `created_at` string, date-time, required
    - `email` string, email, required
    - `has_ai_seat` boolean — HasAISeat intentionally omits omitempty so the API always includes the field, even when false.
    - `id` string, uuid, required
    - `is_service_account` boolean
    - `last_seen_at` string, date-time
    - `login_type` '' | 'password' | 'github' | 'oidc' | 'token' | 'none'
    - `name` string
    - `organization_ids` string[]
    - `roles` CodersdkSlimRole[]
      - `display_name` string
      - `name` string
      - `organization_id` string
    - `status` 'active' | 'dormant' | 'suspended'
    - `theme_preference` string — Deprecated: this value should be retrieved from `codersdk.UserPreferenceSettings` instead.
    - `updated_at` string, date-time
    - `username` string, required

---

[API](https://skmtc.net/coder/apis/coder-api.md) · [All operations](https://skmtc.net/coder/apis/coder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coder/coder-api/versions/56b6e9f08540/schema)