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

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

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

## Request

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

Retrieve details of a specific Private Endpoint.

## Path parameters

- `account_id` integer, required
- `pl_endpoint_ksuid` string, required

## Query parameters

- `include_related` string

## Response `200`

- PrivateEndpointDetailResponse
  - `status` Status
    - `code` integer
    - `is_success` boolean
    - `user_message` string
    - `developer_message` string
  - `data` PrivateEndpointDetail, 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.
    - `port` integer: The network port associated with the Private Endpoint.
    - `provisioning_status` string: Current provisioning status of the Private Endpoint, when known.
    - `provisioning_status_message` string: Customer-facing message describing the current provisioning status, when one is available.
  - `extra` object
  - `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-08-19** (v3) `2574229e3580`: 2 info
  - added the optional property `data/provisioning_status` to the response with the `200` status
  - added the optional property `data/provisioning_status_message` to the response with the `200` status
- **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/:pl_endpoint_ksuid/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)