---
title: "GET /api/v3/accounts/{account_id}/private-endpoints/"
method: GET
path: "/api/v3/accounts/{account_id}/private-endpoints/"
tags: ["Private Endpoints"]
---

# GET /api/v3/accounts/{account_id}/private-endpoints/

`GET /api/v3/accounts/{account_id}/private-endpoints/`

## Request

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

List all Private Endpoints.

## Path parameters

- `account_id` integer, required

## Query parameters

- `include_related` string
- `limit` integer
- `offset` integer
- `search` string
- `type` string

## Response `200`

- PrivateEndpointListResponse
  - `status` Status
    - `code` integer
    - `is_success` boolean
    - `user_message` string
    - `developer_message` string
  - `data` PrivateEndpointList[], required
    - `id` string, required: The unique identifier of the Private Endpoint.
    - `account_id` integer, required: The ID of the account
    - `state` integer, required: The soft-deletion state of the private endpoint record
    - `name` string: The name of the Private Endpoint.
    - `type` string: The type of the Private Endpoint.
    - `private_link_endpoint` string: The PrivateLink endpoint (DNS entry that lives in the dbt Cloud VPC.
    - `cidr_range` string: The CIDR range associated with the Private Endpoint.
    - `egress_cidr` string: Egress CIDR block associated with the Private Endpoint. Used by the customer to allowlist this PLE in their warehouse.
    - `endpoint_identifier` string: The cloud provider's PrivateLink endpoint ID.
    - `endpoint_state` string: The current state of the Private Endpoint.
    - `connectivity_status` string: The connectivity status of the Private Endpoint.
    - `connection_count` integer: The number of active connections using this Private Endpoint.
    - `created_at` string, date-time, required: The timestamp when the Private Endpoint was created.
    - `updated_at` string, date-time, required: The timestamp when the Private Endpoint was last updated.
  - `extra` V3ResponseExtraData, required
    - `filters` V3RequestParams: Base class for all URL request parameters. It is expected that each endpoint extends this class to define its own parameters format
    - `order_by` union
      - string
      - string[]
    - `pagination` V3ResponsePagination, required
      - `count` integer, required
      - `total_count` integer, required
  - `error_code` integer

## Changes

- **2026-10-06** (v3) `7d5c1b4c8d8a`: 1 breaking
  - for the `path` request parameter `account_id`, the format changed from no format to `int64`
- **2026-06-22** (v3) `96a20943ba2f`: 1 info
  - endpoint added
- **2026-03-30** (v3) `e3d35151d3f4`: 1 breaking
  - api path removed without deprecation

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