---
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
    - `hidden` boolean, required
    - `id` string, required
    - `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/versions/4c42fd61ed41/schema)