--- title: "GET /api/v3/accounts/{account_id}/projects/{project_id}/environments/" method: GET path: "/api/v3/accounts/{account_id}/projects/{project_id}/environments/" tags: ["Environments"] --- # GET /api/v3/accounts/{account_id}/projects/{project_id}/environments/ `GET /api/v3/accounts/{account_id}/projects/{project_id}/environments/` ## Request - Base URL: `https://cloud.getdbt.com` - URL: `https://cloud.getdbt.com/api/v3/accounts/{account_id}/projects/{project_id}/environments/` - Auth: HTTP bearer List Environments ## Path parameters - `account_id` integer, required - `project_id` integer, required ## Query parameters - `credentials_id` integer - `dbt_version` string - `dbt_version__in` string[] - `deployment_type` 'production' | 'staging' - `deployment_type__in` string[] - `id__gt` integer - `include_related` string - `limit` integer - `name` string - `name__icontains` string - `offset` integer - `order_by` string - `pk` integer - `pk__in` integer[] - `project_id__in` integer[] - `state` union - integer - 'active' | 'deleted' | 'all' - `type` string ## Response `200` - EnvironmentV3ListEnveloped - `data` EnvironmentV3Response[], required - `id` integer, required - `account_id` integer: The account the environment is associated with - `project_id` integer: The project the environment is associated with - `credentials_id` integer: The id of the associated credentials. Null for development environments. Must be included when updating a deployment environment or the value will be reset to null. - `connection_id` integer: The id of the associated connection. Must be included when updating an environment or the value will be reset to null. - `extended_attributes_id` integer - `name` string: The name of the environment - `dbt_version` string: The default dbt Version to use for this environment - `raw_dbt_version` string, required - `type` 'development' | 'deployment': * `development` - DEVELOPMENT * `deployment` - DEPLOYMENT - `use_custom_branch` boolean - `custom_branch` string - `supports_docs` boolean - `deployment_type` 'production' | 'staging': * `production` - production * `staging` - staging - `is_deferrable` boolean, required - `enable_model_query_history` boolean - `enable_dbt_state` boolean - `enable_dbt_state_model_lock` boolean - `state` integer: A value of 1 means this entity is active and a value of 2 means this entity is deleted - `created_at` string, date-time, required - `updated_at` string, date-time, required - `project` Project, required - `name` string, required: The name of the project - `account_id` integer, required: The account the project is associated with - `description` string: The description of the project - `connection_id` integer: The active connection - `repository_id` integer: The active repository - `semantic_layer_config_id` integer: The active semantic layer configuration - `state` integer, required: A value of 1 means this entity is active and a value of 2 means this entity is deleted - `dbt_project_subdirectory` string: The path in the associated repository where a dbt project can be found - `docs_job_id` integer: The job used for docs generation - `freshness_job_id` integer: The job used for source freshness generation - `type` 0 | 1, required: * `0` - DEFAULT * `1` - HYBRID - `primary_profile_id` integer: The id of the primary profile for this environment - `credentials` PostgresCredentials, required - `account_id` integer, required - `project_id` integer - `type` 'postgres' | 'redshift' | 'snowflake' | 'bigquery' | 'adapter', required: * `postgres` - postgres * `redshift` - redshift * `snowflake` - snowflake * `bigquery` - bigquery * `adapter` - adapter - `state` integer, required: A value of 1 means this entity is active and a value of 2 means this entity is deleted - `threads` integer, required - `username` string, required - `default_schema` string, required - `target_name` string, required - `adapter_version` 'apache_spark_v0' | 'databricks_spark_v0' | 'databricks_v0' | 'trino_v0' | 'snowflake_v0' | 'bigquery_v0' | 'bigquery_v1' | 'postgres_v0' | 'redshift_v0' | 'salesforce_v0' | 'synapse_v0' | 'fabric_v0' | 'athena_v0' | 'teradata_v0' | 'clickhouse_v0': * `apache_spark_v0` - apache_spark_v0 * `databricks_spark_v0` - databricks_spark_v0 * `databricks_v0` - databricks_v0 * `trino_v0` - trino_v0 * `snowflake_v0` - snowflake_v0 * `bigquery_v0` - bigquery_v0 * `bigquery_v1` - bigquery_v1 * `postgres_v0` - postgres_v0 * `redshift_v0` - redshift_v0 * `salesforce_v0` - salesforce_v0 * `synapse_v0` - synapse_v0 * `fabric_v0` - fabric_v0 * `athena_v0` - athena_v0 * `teradata_v0` - teradata_v0 * `clickhouse_v0` - clickhouse_v0 - `fusion_readiness` 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-28** (v3) `e32fbfcdc9ec`: 1 info - added the optional property `data/items/enable_dbt_state_model_lock` to the response with the `200` status - **2026-10-06** (v3) `7d5c1b4c8d8a`: 7 breaking - for the `query` request parameter `pk__in`, the format of property `items/` was specialized from no format to `int64` - for the `query` request parameter `project_id__in`, the format of property `items/` was specialized from no format to `int64` - for the `path` request parameter `account_id`, the format changed from no format to `int64` - for the `path` request parameter `project_id`, the format changed from no format to `int64` - …3 more - **2026-09-29** (v3) `6b5199f1f0c8`: 1 warning - added the new `clickhouse_v0` enum value to the `data/items/credentials/allOf[#/components/schemas/PostgresCredentials]/adapter_version/allOf[#/components/schemas/AdapterVersionEnum]/` response property for the response status `200` - **2026-06-12** (v3) `35ed07b14344`: 1 info - added the optional property `data/items/enable_dbt_state` to the response with the `200` status - **2026-03-31** (v3) `1489e14e5211`: 1 info - removed `#/components/schemas/EnvironmentFusionReadiness` from the `data/items/fusion_readiness` response property `allOf` list for the response status `200` [Operation history](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/changes/api/v3/accounts/:account_id/projects/:project_id/environments/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)