---
title: "GET /api/v3/accounts/{account_id}/projects/{project_id}/connections/"
method: GET
path: "/api/v3/accounts/{account_id}/projects/{project_id}/connections/"
tags: ["Connections"]
deprecated: true
---

# GET /api/v3/accounts/{account_id}/projects/{project_id}/connections/

`GET /api/v3/accounts/{account_id}/projects/{project_id}/connections/`

## Request

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

> **Deprecated.**

List Connections

## Path parameters

- `account_id` integer, required
- `project_id` integer, required

## Query parameters

- `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'
- `has_catalog_ingestion_enabled` boolean
- `has_cost_insights_enabled` boolean
- `has_cost_management_enabled` boolean
- `has_platform_metadata_credentials` boolean
- `include_related` string
- `limit` integer
- `offset` integer
- `order_by` string
- `pk` integer
- `state` union
  - integer
  - 'active' | 'deleted' | 'all'

## Response `200`

- BaseConnectionV3ListEnveloped
  - `data` BaseConnectionV3Response[], required
    - `id` integer, required
    - `account_id` integer: The account the connection is associated with
    - `project_id` integer: The project the connection is associated with
    - `name` string: The name of the connection
    - `type` 'postgres' | 'redshift' | 'snowflake' | 'bigquery' | 'adapter': * `postgres` - postgres * `redshift` - redshift * `snowflake` - snowflake * `bigquery` - bigquery * `adapter` - adapter
    - `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
    - `created_by_id` integer
    - `created_by_service_token_id` integer
    - `state` integer: A value of 1 means this entity is active and a value of 2 means this entity is deleted
    - `private_link_endpoint_id` string
    - `oauth_redirect_uri` string, required: If OAuth is enabled for this connection, this field is used internally by dbt Cloud
    - `oauth_configuration_id` integer: The OAuth Configuration associated with this connection. When set,developer credentials leveraging OAuth may be created.
    - `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-10-06** (v3) `7d5c1b4c8d8a`: 3 breaking
  - 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`
  - for the `query` request parameter `pk`, the format changed from no format to `int64`
- **2026-09-29** (v3) `6b5199f1f0c8`: 1 warning, 1 info
  - added the new `clickhouse_v0` enum value to the `data/items/adapter_version` response property for the response status `200`
  - added the new enum value `clickhouse_v0` to the `query` request parameter `adapter_version`
- **2026-07-07** (v3) `fd8eb7c4cb2e`: 1 warning
  - deleted the `query` request parameter `project_id__in`

[Operation history](https://skmtc.dev/getdbt/apis/dbt-cloud-api-v2/changes/api/v3/accounts/:account_id/projects/:project_id/connections/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)
