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

# List

`GET /servers`

List all servers.

## Response `200`

Get all servers.

- Server[]
  - `id` integer — The server ID.
  - `uuid` string — The server UUID.
  - `name` string — The server name.
  - `description` string — The server description.
  - `ip` string — The IP address.
  - `user` string — The user.
  - `port` integer — The port number.
  - `proxy` object — The proxy configuration.
  - `proxy_type` 'traefik' | 'caddy' | 'none' — The proxy type.
  - `high_disk_usage_notification_sent` boolean — The flag to indicate if the high disk usage notification has been sent.
  - `unreachable_notification_sent` boolean — The flag to indicate if the unreachable notification has been sent.
  - `unreachable_count` integer — The unreachable count for your server.
  - `validation_logs` string — The validation logs.
  - `log_drain_notification_sent` boolean — The flag to indicate if the log drain notification has been sent.
  - `swarm_cluster` string — The swarm cluster configuration.
  - `settings` ServerSetting — Server Settings model
    - `id` integer
    - `concurrent_builds` integer
    - `deployment_queue_limit` integer
    - `backup_compression_cpu_percentage` integer
    - `dynamic_timeout` integer
    - `force_disabled` boolean
    - `force_server_cleanup` boolean
    - `server_role` 'deployment' | 'build' | 'both'
    - `is_cloudflare_tunnel` boolean
    - `is_jump_server` boolean
    - `is_logdrain_axiom_enabled` boolean
    - `is_logdrain_custom_enabled` boolean
    - `is_logdrain_highlight_enabled` boolean
    - `is_logdrain_newrelic_enabled` boolean
    - `is_metrics_enabled` boolean
    - `is_traffic_analytics_enabled` boolean
    - `traffic_topn` integer
    - `traffic_sample_threshold` integer
    - `traffic_retention_1h_days` integer
    - `traffic_retention_1d_days` integer
    - `is_geoip_enabled` boolean
    - `geoip_refresh_days` integer
    - `is_reachable` boolean
    - `is_sentinel_enabled` boolean
    - `is_swarm_manager` boolean
    - `is_swarm_worker` boolean
    - `is_terminal_enabled` boolean
    - `is_usable` boolean
    - `logdrain_axiom_api_key` string
    - `logdrain_axiom_dataset_name` string
    - `logdrain_custom_config` string
    - `logdrain_custom_config_parser` string
    - `logdrain_highlight_project_id` string
    - `logdrain_newrelic_base_uri` string
    - `logdrain_newrelic_license_key` string
    - `sentinel_metrics_history_days` integer
    - `sentinel_metrics_refresh_rate_seconds` integer
    - `sentinel_token` string
    - `docker_cleanup_frequency` string
    - `docker_cleanup_threshold` integer
    - `server_id` integer
    - `wildcard_domain` string
    - `created_at` string
    - `updated_at` string
    - `delete_unused_volumes` boolean — The flag to indicate if the unused volumes should be deleted.
    - `delete_unused_networks` boolean — The flag to indicate if the unused networks should be deleted.
    - `connection_timeout` integer — SSH connection timeout in seconds.
    - `docker_version` string, nullable — Detected Docker Engine version on the server.
    - `docker_version_checked_at` string, nullable — When Docker Engine version was last detected.
    - `compose_version` string, nullable — Detected Docker Compose plugin version on the server.
    - `compose_version_checked_at` string, nullable — When Docker Compose version was last detected.

## Other responses

- `400` — Invalid token.
- `401` — Unauthenticated.

## Changes

- **2026-09-26** `f8b16020e5dd` — 1 warning, 1 info
  - removed the optional property `items/settings/is_build_server` from the response with the `200` status
  - added the optional property `items/settings/server_role` to the response with the `200` status
- **2026-09-19** `b5f81ea5b5b5` — 12 info
  - added the optional property `items/settings/backup_compression_cpu_percentage` to the response with the `200` status
  - added the optional property `items/settings/compose_version` to the response with the `200` status
  - added the optional property `items/settings/compose_version_checked_at` to the response with the `200` status
  - added the optional property `items/settings/docker_version` to the response with the `200` status
  - …8 more
- **2026-04-28** `7ca1e345dc2c` — 1 info
  - added the optional property `items/settings/connection_timeout` to the response with the `200` status
- **2026-03-16** `385ee693a76d` — 1 warning
  - removed the optional property `items/settings/connection_timeout` from the response with the `200` status

[Change history](https://skmtc.dev/coollabsio/apis/coolify/changes/servers/get.md)

---

[API](https://skmtc.dev/coollabsio/apis/coolify.md) · [All operations](https://skmtc.dev/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc.dev/coollabsio/apis/coolify/revisions/f8b16020e5dd?raw)