---
title: "Retrieve all servers"
method: GET
path: "/api/v1/servers"
tags: ["Servers"]
---

# Retrieve all servers

`GET /api/v1/servers`

## Query parameters

- `Limit` integer
- `Offset` integer
- `ProjectId` integer
- `SortBy` string
- `SortDirection` string
- `Search` string
- `StartRam` number, double
- `EndRam` number, double
- `StartDiskSize` integer
- `EndDiskSize` integer
- `StartCpu` integer
- `EndCpu` integer
- `OrganizationId` integer
- `Id` integer
- `FilterBy` string
- `AutoscalingGroup` string

## Response `200`

OK

- ServersList
  - `data` ServerListDto[], nullable, required
    - `id` integer, required
    - `name` string, required
    - `projectName` string, required
    - `organizationName` string, required
    - `organizationId` integer, required
    - `projectId` integer, required
    - `ipAddress` string, nullable, required
    - `diskSize` number, double, required
    - `kubernetesHealth` string, nullable, required
    - `cpu` integer, required
    - `ram` number, double, required
    - `role` 'Bastion' | 'Kubemaster' | 'Kubeworker' | 'AllInOne', required
    - `status` string, required
    - `createdAt` string, required
    - `cloudType` 'NONE' | 'AWS' | 'AZURE' | 'GOOGLE' | 'OPENSTACK' | 'PROXMOX' | 'TANZU' | 'OPENSHIFT' | 'VSPHERE' | 'ZADARA' | 'ZEDEDA' | 'GENERICKUBERNETES', required
    - `createdBy` string, required
    - `lastModified` string, nullable, required
    - `lastModifiedBy` string, nullable, required
    - `spotPrice` number, double, required
    - `spotInstance` boolean, required
    - `shutOff` boolean, required
    - `useLocalDisk` boolean
    - `autoscalingGroup` string, nullable, required
    - `providerID` string, nullable, required
    - `instanceId` string, nullable, required
    - `awsHostName` string, nullable, required
    - `availabilityZone` string, nullable, required
    - `hypervisor` string, nullable, required
    - `hypervisorId` string, nullable, required
    - `proxmoxRole` 'NONE' | 'NFS' | 'STORAGE', required
    - `proxmoxExtraDiskSize` integer, required
    - `actionButtons` ServerActionButtonVisibilityDto
      - `status` boolean
      - `reboot` boolean
      - `console` boolean
    - `kubernetesNodeLabels` KubernetesNodeLabelsDto[], required
      - `key` string, nullable, required
      - `value` string, nullable, required
    - `replicaCount` integer, nullable, required
    - `wasmEnabled` boolean, required
    - `flavor` string, nullable, required
  - `totalCount` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.dev/taikun/apis/taikun-webapi.md) · [All operations](https://skmtc.dev/taikun/apis/taikun-webapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/taikun/taikun-webapi/revisions/09395964d191/schema)