Hetzner Cloud API
  1. Servers
Hetzner Cloud API
  • Actions
    • Get all Actions
      GET
    • Get an Action
      GET
  • Certificates
    • Get all Certificates
      GET
    • Create a Certificate
      POST
    • Delete a Certificate
      DELETE
    • Get a Certificate
      GET
    • Update a Certificate
      PUT
  • Certificate Actions
    • Get all Actions for a Certificate
      GET
    • Retry Issuance or Renewal
      POST
    • Get an Action for a Certificate
      GET
  • Datacenters
    • Get all Datacenters
      GET
    • Get a Datacenter
      GET
  • Firewalls
    • Get all Firewalls
      GET
    • Create a Firewall
      POST
    • Delete a Firewall
      DELETE
    • Get a Firewall
      GET
    • Update a Firewall
      PUT
  • Firewall Actions
    • Get all Actions for a Firewall
      GET
    • Apply to Resources
      POST
    • Remove from Resources
      POST
    • Set Rules
      POST
    • Get an Action for a Firewall
      GET
  • Floating IPs
    • Get all Floating IPs
    • Create a Floating IP
    • Delete a Floating IP
    • Get a Floating IP
    • Update a Floating IP
  • Floating IP Actions
    • Get all Actions for a Floating IP
    • Assign a Floating IP to a Server
    • Change reverse DNS entry for a Floating IP
    • Change Floating IP Protection
    • Unassign a Floating IP
    • Get an Action for a Floating IP
  • Images
    • Get all Images
    • Delete an Image
    • Get an Image
    • Update an Image
  • Image Actions
    • Get all Actions for an Image
    • Change Image Protection
    • Get an Action for an Image
  • ISOs
    • Get all ISOs
    • Get an ISO
  • Load Balancer Types
    • Get all Load Balancer Types
    • Get a Load Balancer Type
  • Load Balancers
    • Get all Load Balancers
    • Create a Load Balancer
    • Delete a Load Balancer
    • Get a Load Balancer
    • Update a Load Balancer
    • Get Metrics for a LoadBalancer
  • Load Balancer Actions
    • Get all Actions for a Load Balancer
    • Add Service
    • Add Target
    • Attach a Load Balancer to a Network
    • Change Algorithm
    • Change reverse DNS entry for this Load Balancer
    • Change Load Balancer Protection
    • Change the Type of a Load Balancer
    • Delete Service
    • Detach a Load Balancer from a Network
    • Disable the public interface of a Load Balancer
    • Enable the public interface of a Load Balancer
    • Remove Target
    • Update Service
    • Get an Action for a Load Balancer
  • Locations
    • Get all Locations
    • Get a Location
  • Networks
    • Get all Networks
    • Create a Network
    • Delete a Network
    • Get a Network
    • Update a Network
  • Network Actions
    • Get all Actions for a Network
    • Add a route to a Network
    • Add a subnet to a Network
    • Change IP range of a Network
    • Change Network Protection
    • Delete a route from a Network
    • Delete a subnet from a Network
    • Get an Action for a Network
  • Placement Groups
    • Get all PlacementGroups
    • Create a PlacementGroup
    • Delete a PlacementGroup
    • Get a PlacementGroup
    • Update a PlacementGroup
  • Pricing
    • Get all prices
  • Server Types
    • Get all Server Types
    • Get a Server Type
  • Servers
    • Get all Servers
      GET
    • Create a Server
      POST
    • Delete a Server
      DELETE
    • Get a Server
      GET
    • Update a Server
      PUT
    • Get Metrics for a Server
      GET
  • Server Actions
    • Get all Actions for a Server
    • Add a Server to a Placement Group
    • Attach an ISO to a Server
    • Attach a Server to a Network
    • Change alias IPs of a Network
    • Change reverse DNS entry for this Server
    • Change Server Protection
    • Change the Type of a Server
    • Create Image from a Server
    • Detach a Server from a Network
    • Detach an ISO from a Server
    • Disable Backups for a Server
    • Disable Rescue Mode for a Server
    • Enable and Configure Backups for a Server
    • Enable Rescue Mode for a Server
    • Power off a Server
    • Power on a Server
    • Soft-reboot a Server
    • Rebuild a Server from an Image
    • Remove from Placement Group
    • Request Console for a Server
    • Reset a Server
    • Reset root Password of a Server
    • Shutdown a Server
    • Get an Action for a Server
  • SSH Keys
    • Get all SSH keys
    • Create an SSH key
    • Delete an SSH key
    • Get a SSH key
    • Update an SSH key
  • Volumes
    • Get all Volumes
    • Create a Volume
    • Delete a Volume
    • Get a Volume
    • Update a Volume
  • Volume Actions
    • Get all Actions for a Volume
    • Attach Volume to a Server
    • Change Volume Protection
    • Detach Volume
    • Resize Volume
    • Get an Action for a Volume
  • Primary IPs
    • Get all Primary IPs
    • Create a Primary IP
    • Delete a Primary IP
    • Get a Primary IP
    • Update a Primary IP
  • Primary IP Actions
    • Assign a Primary IP to a resource
    • Change reverse DNS entry for a Primary IP
    • Change Primary IP Protection
    • Unassign a Primary IP from a resource
  1. Servers

Get all Servers

GET
/servers
Returns all existing Server objects

Request

Query Params

Responses

🟢200A paged array of servers
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.hetzner.cloud/v1/servers'
Response Response Example
{
    "meta": {
        "pagination": {
            "last_page": 4,
            "next_page": 4,
            "page": 3,
            "per_page": 25,
            "previous_page": 2,
            "total_entries": 100
        }
    },
    "servers": [
        {
            "backup_window": "22-02",
            "created": "2016-01-30T23:55:00.000Z",
            "datacenter": {
                "description": "Falkenstein DC Park 8",
                "id": 42,
                "location": {
                    "city": "Falkenstein",
                    "country": "DE",
                    "description": "Falkenstein DC Park 1",
                    "id": 1,
                    "latitude": 50.47612,
                    "longitude": 12.370071,
                    "name": "fsn1",
                    "network_zone": "eu-central"
                },
                "name": "fsn1-dc8",
                "server_types": {
                    "available": [
                        1,
                        2,
                        3
                    ],
                    "available_for_migration": [
                        1,
                        2,
                        3
                    ],
                    "supported": [
                        1,
                        2,
                        3
                    ]
                }
            },
            "id": 42,
            "image": {
                "bound_to": null,
                "created": "2016-01-30T23:55:00.000Z",
                "created_from": {
                    "id": 1,
                    "name": "Server"
                },
                "deleted": null,
                "deprecated": "2018-02-28T00:00:00.000Z",
                "description": "Ubuntu 20.04 Standard 64 bit",
                "disk_size": 10,
                "id": 42,
                "image_size": 2.3,
                "labels": {
                    "property1": "string",
                    "property2": "string"
                },
                "name": "ubuntu-20.04",
                "os_flavor": "ubuntu",
                "os_version": "20.04",
                "protection": {
                    "delete": false
                },
                "rapid_deploy": false,
                "status": "available",
                "type": "snapshot"
            },
            "included_traffic": 654321,
            "ingoing_traffic": 123456,
            "iso": {
                "deprecated": "2018-02-28T00:00:00.000Z",
                "description": "FreeBSD 11.0 x64",
                "id": 42,
                "name": "FreeBSD-11.0-RELEASE-amd64-dvd1",
                "type": "public"
            },
            "labels": {
                "property1": "string",
                "property2": "string"
            },
            "load_balancers": [
                0
            ],
            "locked": false,
            "name": "my-resource",
            "outgoing_traffic": 123456,
            "placement_group": {
                "created": "2016-01-30T23:55:00.000Z",
                "id": 42,
                "labels": {
                    "property1": "string",
                    "property2": "string"
                },
                "name": "my-resource",
                "servers": [
                    42
                ],
                "type": "spread"
            },
            "primary_disk_size": 50,
            "private_net": [
                {
                    "alias_ips": [
                        "string"
                    ],
                    "ip": "10.0.0.2",
                    "mac_address": "86:00:ff:2a:7d:e1",
                    "network": 4711
                }
            ],
            "protection": {
                "delete": false,
                "rebuild": false
            },
            "public_net": {
                "firewalls": [
                    {
                        "id": 42,
                        "status": "applied"
                    }
                ],
                "floating_ips": [
                    478
                ],
                "ipv4": {
                    "blocked": false,
                    "dns_ptr": "server01.example.com",
                    "id": 42,
                    "ip": "1.2.3.4"
                },
                "ipv6": {
                    "blocked": false,
                    "dns_ptr": [
                        {
                            "dns_ptr": "server.example.com",
                            "ip": "2001:db8::1"
                        }
                    ],
                    "id": 42,
                    "ip": "2001:db8::/64"
                }
            },
            "rescue_enabled": false,
            "server_type": {
                "cores": 1,
                "cpu_type": "shared",
                "deprecated": false,
                "description": "CX11",
                "disk": 25,
                "id": 1,
                "memory": 1,
                "name": "cx11",
                "prices": [
                    {
                        "location": "fsn1",
                        "price_hourly": {
                            "gross": "1.1900000000000000",
                            "net": "1.0000000000"
                        },
                        "price_monthly": {
                            "gross": "1.1900000000000000",
                            "net": "1.0000000000"
                        }
                    }
                ],
                "storage_type": "local"
            },
            "status": "running",
            "volumes": [
                0
            ]
        }
    ]
}
Modified at 2023-08-16 03:09:21
Previous
Get a Server Type
Next
Create a Server
Built with