---
title: "List Servers"
method: GET
path: "/servers"
tags: ["Servers"]
---

# List Servers

`GET /servers`

## Request

- Base URL: `https://gpucloud.ca/api`
- URL: `https://gpucloud.ca/api/servers`
- Auth: HTTP bearer

List all GPU servers owned by the authenticated user.

## Response `200`

List of servers

- object
  - `data` ServerSummary[]
    - `id` string
    - `name` string
    - `status` 'PROVISIONING' | 'ACTIVE' | 'STOPPED' | 'REBOOTING' | 'HIBERNATED' | 'ERROR' | 'DELETED'
    - `gpu` string
    - `specs` object
      - `vcores` integer
      - `ram` integer
      - `storage` integer
    - `ipv4` string, nullable
    - `region` string
    - `monthlyCost` number
    - `createdAt` string, date-time

## Other responses

- `401`: No API key (accountAction.code NO_API_KEY) or an invalid, expired, revoked or read only key on a write (INVALID_API_KEY). Provide a valid API key as `Authorization: Bearer <key>`; accountAction gives the links to create an account and a key.
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/gpucloud/apis/gpu-cloud-api.md) · [All operations](https://skmtc.dev/gpucloud/apis/gpu-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gpucloud/apis/gpu-cloud-api/revisions/ed530411f5c7?raw)