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 a Server

GET
/servers/{id}
Returns a specific Server object. The Server must exist inside the Project

Request

Path Params

Responses

🟢200The `server` key in the reply contains a Server object with this structure
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.hetzner.cloud/v1/servers/'
Response Response Example
{
    "server": {
        "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
Delete a Server
Next
Update a Server
Built with