--- title: "GET /api/v3/accounts/" method: GET path: "/api/v3/accounts/" tags: ["Accounts"] --- # GET /api/v3/accounts/ `GET /api/v3/accounts/` ## Request - Base URL: `https://cloud.getdbt.com` - URL: `https://cloud.getdbt.com/api/v3/accounts/` - Auth: HTTP bearer List the Accounts that your API Token is authorized to access. ## Query parameters - `include_related` string ## Response `200` - AccountListEnveloped - `data` AccountResponse[], required - `id` integer, required - `name` string: The name of the account - `plan` 'cancelled' | 'cancelled_2022' | 'cancelled_2025' | 'developer' | 'developer_2022' | 'enterprise' | 'enterprise_2025' | 'enterprise_plus_2025' | 'free' | 'starter_2025' | 'team' | 'team_2022' | 'team_annual' | 'trial' | 'trial_2022' | 'trial_2025' | 'usage_2026' | 'usage_managed_2026', required: * `cancelled` - CANCELLED * `cancelled_2022` - CANCELLED_2022 * `cancelled_2025` - CANCELLED_2025 * `developer` - DEVELOPER * `developer_2022` - DEVELOPER_2022 * `enterprise` - ENTERPRISE * `enterprise_2025` - ENTERPRISE_2025 * `enterprise_plus_2025` - ENTERPRISE_PLUS_2025 * `free` - FREE * `starter_2025` - STARTER_2025 * `team` - TEAM * `team_2022` - TEAM_2022 * `team_annual` - TEAM_ANNUAL * `trial` - TRIAL * `trial_2022` - TRIAL_2022 * `trial_2025` - TRIAL_2025 * `usage_2026` - USAGE_2026 * `usage_managed_2026` - USAGE_MANAGED_2026 - `run_slots` integer, required: The total number of run slots the account may use - `developer_seats` integer, required: The total number of developer seats the account may use - `it_seats` integer, required: The total number of IT seats the account may use - `explorer_seats` integer, required: The total number of explorer seats the account may use - `analyst_seats` integer, required: The total number of pre-purchased analyst seats for the account - `read_only_seats` integer, required: The total number of Read Only seats the account may use - `locked` boolean, required: Whether the account is currently locked - `lock_reason` string, required: Why the account is locked - `lock_cause` 'trial_expired' | 'cancelled' | 'unpaid' | 'provisioned_team_annual' | 'other' | 'migrated' | 'workshop', required: * `trial_expired` - TRIAL_EXPIRED * `cancelled` - CANCELLED * `unpaid` - UNPAID * `provisioned_team_annual` - PROVISIONED_TEAM_ANNUAL * `other` - OTHER * `migrated` - MIGRATED * `workshop` - WORKSHOP - `unlocked_at` string, date-time, required - `pending_cancel` boolean, required: Whether the account is pending cancellation - `billing_email_address` string, required: The email address to send billing notifications to - `pod_memory_request_mebibytes` integer, required: The amount of memory (in MiB) to request for run pods - `develop_pod_memory_request_mebibytes` integer, required: The amount of memory (in MiB) to request for develop pods - `run_duration_limit_seconds` integer, required: The maximum duration that a run may is permitted to execute for before it is terminated - `queue_limit` integer, required: The maximum number of runs that may be queued at once - `enterprise_login_slug` string, required: The enterprise login URL, if available - `business_critical` boolean, required: Whether this account is on a Business Critical plan - `default_license_type` 'developer' | 'read_only' | 'analyst' | 'it': * `developer` - DEVELOPER * `read_only` - READ_ONLY * `analyst` - ANALYST * `it` - IT - `starter_repo_url` string, required: If defined, the URL used to initialize new dbt projects - `git_auth_level` string, required - `identifier` string, required: A globally unique (cross-cell) identifier - `trial_end_date` string, date-time, required - `static_subdomain` string, required - `vanity_subdomain` string, required - `run_locked_until` string, date-time, required - `state` integer: A value of 1 means this entity is active and a value of 2 means this entity is deleted - `docs_job_id` integer: (Deprecated) - `freshness_job_id` integer: (Deprecated) - `copilot_locked_until` string, date-time, required: When copilot will be enabled again for the account - `agent_credit_locked` boolean, required: True when the account's agent-credit balance is depleted and dbt-owned-key agent calls should be refused. Cleared on successful top-up. - `account_migration_events` unknown[], required: (Deprecated) - unknown - `groups` Group[], required: The user groups in the account - `account_id` integer, required - `name` string, required - `state` integer, required: A value of 1 means this entity is active and a value of 2 means this entity is deleted - `assign_by_default` boolean, required - `sso_mapping_groups` string[] - `created_at` string, date-time, required - `updated_at` string, date-time, 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-09-28** (v3) `b73c62c3efef`: 1 info - added the optional property `data/items/default_license_type` to the response with the `200` status - **2026-07-23** (v3) `2711a1bb79a0`: 1 warning - added the new `usage_managed_2026` enum value to the `data/items/plan/allOf[#/components/schemas/PlanEnum]/` response property for the response status `200` - **2026-06-02** (v3) `14244b798c0d`: 1 warning - added the new `usage_2026` enum value to the `data/items/plan/allOf[#/components/schemas/PlanEnum]/` response property for the response status `200` - **2026-05-11** (v3) `edaabf0f716c`: 1 info - added the required property `data/items/agent_credit_locked` to the response with the `200` status [Operation history](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/changes/api/v3/accounts/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)