---
title: "GET /api/v3/accounts/{account_id}/users/"
method: GET
path: "/api/v3/accounts/{account_id}/users/"
tags: ["Users"]
---

# GET /api/v3/accounts/{account_id}/users/

`GET /api/v3/accounts/{account_id}/users/`

## Request

- Base URL: `https://cloud.getdbt.com`
- URL: `https://cloud.getdbt.com/api/v3/accounts/{account_id}/users/`
- Auth: HTTP bearer

List users for a given account.

## Path parameters

- `account_id` integer, required

## Query parameters

- `group_id` integer
- `include_related` string
- `license_type` 'analyst' | 'developer' | 'it' | 'read_only'
- `limit` integer
- `offset` integer
- `omit_permissions` '0' | '1'
- `order_by` '-created_at' | '-date_joined' | '-email' | '-email_verified' | '-first_name' | '-id' | '-last_login' | '-last_name' | '-license_type' | '-pk' | '-scim_managed' | '-updated_at' | '-username' | 'created_at' | 'date_joined' | 'email' | 'email_verified' | 'first_name' | 'id' | 'last_login' | 'last_name' | 'license_type' | 'pk' | 'scim_managed' | 'updated_at' | 'username'
- `pk` integer
- `pk__in` string
- `search` string

## Response `200`

- UserListEnveloped
  - `data` UserResponse[], required
    - `id` integer, required
    - `first_name` string
    - `last_name` string
    - `email` string, required
    - `apitoken_last_used` string, date-time, required
    - `azure_active_directory_connected` boolean, required
    - `azure_active_directory_token_retrieval_failure` boolean, required
    - `azure_active_directory_username` string, required
    - `email_connected` boolean, required
    - `email_verified` boolean, required
    - `enterprise_connected` boolean, required
    - `enterprise_authentication_method` string, required
    - `github_connected` boolean, required
    - `github_username` string, required
    - `gitlab_connected` boolean, required
    - `gitlab_username` string, required
    - `is_active` boolean, required
    - `is_staff` boolean, required
    - `last_login` string, date-time, required
    - `show_existing_user_email_verification` boolean, required
    - `sso_only_user` boolean, required
    - `github_token_retrieval_failure` boolean, required
    - `gitlab_token_retrieval_failure` boolean, required
    - `created_at` string, date-time, required
    - `permissions` UserLicense[], required
      - `license_type` string, required: The type of license, e.g. `developer` or `read_only`
      - `state` integer, required: A value of 1 means this entity is active and a value of 2 means this entity is deleted
    - `auth_provider_infos` unknown, required
    - `licenses` unknown, required
  - `extra` Extra, required
    - `filters` object, required: Filters applied to the request
    - `order_by` string, required: Ordering applied to the request
    - `pagination` CustomPagination, required
      - `count` integer, required: Number of items in the current page
      - `total_count` integer, required: Total number of items
  - `status` ResponseStatus, required
    - `code` integer: HTTP status code
    - `is_success` boolean, required: Whether the request was successful or not
    - `user_message` string, required: End-user friendly success or error message
    - `developer_message` string, required: Developer friendly success or error message

## Changes

- **2026-10-22** (v3) `665e2f199a5f`: 9 info
  - added the new optional `query` request parameter `group_id`
  - added the new optional `query` request parameter `license_type`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`
  - …5 more
- **2026-10-06** (v3) `7d5c1b4c8d8a`: 1 breaking
  - for the `path` request parameter `account_id`, the format changed from no format to `int64`
- **2026-08-28** (v3) `c21278a3a4b5`: 1 info
  - added the required property `data/items/show_existing_user_email_verification` to the response with the `200` status

[Operation history](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/changes/api/v3/accounts/:account_id/users/get.md)

---

[API](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2.md) - [All operations](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/revisions/2448b375ac2f?raw)