---
title: "Get a cluster with its replicas and GPU model"
method: GET
path: "/v1/clusters/{id}/detail"
tags: ["Clusters"]
---

# Get a cluster with its replicas and GPU model

`GET /v1/clusters/{id}/detail`

## Path parameters

- `id` string, required

## Response `200`

The cluster detail

- ClusterDetail
  - `allowFallback` boolean, required
  - `containerPort` integer
  - `createdAt` string, required
  - `deployToken` string
  - `diskSizeGb` integer, required
  - `endpointUrl` string
  - `envVars` object
  - `gpuModel` GpuModel
    - `architecture` string
    - `createdAt` string
    - `formFactor` string — Board type: "sxm", "pcie", "nvl", "oam", or absent when unknown. One GPU die ships in several boards that differ in memory type, TDP and peer bandwidth, so they are separate models at separate prices. Read this instead of parsing name.
    - `hidden` boolean, required
    - `id` string, required
    - `interconnect` string — Peer fabric: "nvlink", "nvswitch", "infinity-fabric", or absent for PCIe-only parts. Present here so a client can tell an NVLink-capable SKU from a PCIe one without parsing name.
    - `manufacturer` string, required
    - `name` string, required
    - `vramGb` integer, required
  - `gpuModelId` string
  - `gpusPerReplica` integer, required
  - `healthCheckPath` string
  - `healthCheckPort` integer
  - `healthChecks` string[]
  - `id` string, required
  - `imageUrl` string
  - `name` string, required
  - `notes` string
  - `organizationId` string, required
  - `preferredRegions` string[]
  - `privileged` boolean, required
  - `replicaCount` integer, required
  - `replicas` ClusterReplicaItem[], required
    - `consecutiveFailures` integer
    - `createdAt` string, required
    - `diskTotalBytes` integer
    - `diskUpdatedAt` string
    - `diskUsedBytes` integer
    - `endpointUrl` string
    - `gpuCount` integer, required
    - `healthy` boolean, required
    - `id` string, required
    - `internalIp` string
    - `lastHealthCheckAt` string
    - `nodeHostname` string
    - `nodeId` string
    - `nodeLocation` string
    - `nodeRegion` string
    - `nvlinkEnabled` boolean, required
    - `port` integer
    - `sshPort` integer
    - `startedAt` string
    - `status` string, required
  - `resourceSize` string, required
  - `status` string, required
  - `statusReason` string — human-readable cause for failed/stuck states
  - `tier` string, required
  - `updatedAt` string, required

## Other responses

- `401` — Missing or invalid API key
- `403` — API key lacks the required scope
- `404` — Resource not found

---

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