---
title: "Get a data plane"
method: GET
path: "/orgs/current/data-planes/{id}"
tags: ["data_planes"]
---

# Get a data plane

`GET /orgs/current/data-planes/{id}`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/orgs/current/data-planes/{id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-Organization-Id`
  - HTTP bearer

Returns a data plane and its saved provisioning settings in any lifecycle state. Requires BYOC and organization:infrastructure:read.

## Path parameters

- `id` string, uuid, required

## Response `200`

Data plane

- DataPlanesPublicDataPlane
  - `api_url` string
  - `created_at` string
  - `firewall` DataPlanesDataPlaneFirewallSettings
    - `allow_http` boolean, required
    - `allowed_cidrs` object, required
    - `allowed_domains` string[], required
  - `fleet_oidc` DataPlanesDataPlaneFleetOIDCSettings
    - `audience` string, required
    - `email_claim` string, required
    - `groups_claim` string, required
    - `is_enabled` boolean, required
    - `issuer_url` string, required
    - `provider` string, required
    - `subject_claim` string, required
    - `tenant_claim` string, required
    - `tenant_mappings` object, required
  - `id` string
  - `maintenance_window` string
  - `name` string
  - `provisioning_settings` DataPlanesDataPlaneProvisioningSettings
    - `additional_tags` object
    - `azure_entra_tenant_id` string: EntraTenantID is the Microsoft Entra tenant of the resource group.
    - `byoiam` DataPlanesDataPlaneBYOIAMSettings
      - `is_enabled` boolean: True when the customer created the data plane IAM resources.
    - `byovpc` DataPlanesDataPlaneBYOVPCSettings
      - `private_app_subnet_ids` string[]
      - `private_db_subnet_ids` string[]
      - `public_subnet_ids` string[]
      - `vpc_id` string
    - `cloud` 'AWS' | 'AZURE' | 'GCP'
    - `gcp_project_id` string: ProjectID is the customer project that hosts the data plane.
    - `is_eks_api_privatelink_disabled` boolean
    - `is_gcp_byoiam_enabled` boolean: IsGCPBYOIAMEnabled is true when the customer created the data plane service accounts. It has its own name because AWS has the byoiam object.
    - `is_public_load_balancer` boolean
    - `provisioner_service_account` string: ProvisionerServiceAccount is the customer service account that the control plane impersonates.
    - `resource_group_id` string
    - `role_arn` string
    - `trace_storage` 'CLICKHOUSE' | 'SMITHDB'
    - `vpc_cidr` string: VPCCIDR is the effective AWS VPC, Azure VNet, or GCP VPC network CIDR, including for customer-managed VPCs.
  - `region` string
  - `status` 'requested' | 'provisioning' | 'provisioning_failed' | 'active' | 'updating' | 'inactive' | 'deprovisioning' | 'deleted' | 'revoked'
  - `status_updated_at` string
  - `ttl` DataPlanesDataPlaneTTLSettings
    - `enabled` boolean, required
    - `long_days` integer, required
    - `short_days` integer, required
  - `workspaces` DataPlanesPublicDataPlaneWorkspace[]
    - `id` string
    - `name` string

## Other responses

- `400`: Invalid data plane or organization ID
- `403`: BYOC not enabled or insufficient permissions
- `404`: Data plane not found

## Changes

- **2026-10-22** `e45f16e950dc`: 1 warning, 1 info
  - removed the optional property `provisioning_settings/is_byoiam_enabled` from the response with the `200` status
  - added the optional property `provisioning_settings/byoiam` to the response with the `200` status
- **2026-10-16** `1a8ee9358d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/orgs/current/data-planes/:id/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)