---
title: "Get Cluster"
method: GET
path: "/api/admin/clusters/{cluster_id}"
tags: ["admin-clusters"]
---

# Get Cluster

`GET /api/admin/clusters/{cluster_id}`

Return full DB details for one cluster (columns + nodes + SSH keys).

## Path parameters

- `cluster_id` string, required

## Response `200`

Successful Response

- GenericResponseClusterDetailResponse
  - `data` ClusterDetailResponse — All DB details for a single cluster (columns + nodes + SSH keys).
    - `id` string, required
    - `remoteId` string, required
    - `name` string, required
    - `providerType` string, required
    - `status` string, required
    - `vaultEnabled` boolean, required
    - `gpuName` string, required
    - `gpuCount` integer, required
    - `socket` string, nullable
    - `priceHr` number, nullable
    - `stoppedPriceHr` number, nullable
    - `provisioningPriceHr` number, nullable
    - `basePriceHr` number, nullable
    - `baseCurrency` string, nullable
    - `userId` string, nullable
    - `teamId` string, nullable
    - `walletId` string, nullable
    - `orchestratorType` string, required
    - `orchestratorVersion` string, nullable
    - `orchestratorEndpoint` string, nullable
    - `orchestratorConfig` unknown
    - `orchestratorDeploymentJobId` string, nullable
    - `orchestratorDeploymentStatus` string, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `terminatedAt` string, date-time, nullable
    - `info` unknown
    - `nodes` ClusterNodeDetail[]
      - `id` string, required
      - `name` string, required
      - `remoteId` string, required
      - `providerType` string, required
      - `type` string, nullable
      - `status` string, required
      - `installationStatus` string, nullable
      - `testStatus` string, nullable
      - `finalizerStatus` string, nullable
      - `installationProgress` integer, nullable
      - `installationFailure` string, nullable
      - `gpuName` string, required
      - `gpuCount` integer, required
      - `socket` string, nullable
      - `priceHr` number, nullable
      - `stoppedPriceHr` number, nullable
      - `provisioningPriceHr` number, nullable
      - `basePriceHr` number, nullable
      - `baseCurrency` string, nullable
      - `environmentType` string, nullable
      - `userId` string, nullable
      - `teamId` string, nullable
      - `walletId` string, nullable
      - `isDetached` boolean
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `terminatedAt` string, date-time, nullable
      - `providerReadyAt` string, date-time, nullable
      - `piReadyAt` string, date-time, nullable
      - `info` unknown
      - `connections` ClusterNodeConnection[]
        - `podId` string, required
        - `podName` string, nullable
        - `host` string, required
        - `port` integer
        - `user` string, required
        - `role` string, nullable
        - `isControlNode` boolean
    - `sshKeys` ClusterSSHKeyDetail[]
      - `id` string, required
      - `userId` string, nullable
      - `sshKeyId` string, nullable
      - `role` string, required
      - `publicKey` string, nullable
  - `status` string, nullable — Response status

## Other responses

- `401` — Authorization failed
- `403` — Insufficient permissions
- `422` — Invalid request data

---

[API](https://skmtc.net/primeintellect/apis/pi-api.md) · [All operations](https://skmtc.net/primeintellect/apis/pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primeintellect/pi-api/revisions/3d3868828a78/schema)