Data Centers

List Data Centers

Deprecated: This endpoint is deprecated as of 01 June 2026 and will be removed after 01 October 2026.

Returns all Data Centers.

get/datacenters

Request

Base URL: https://api.hetzner.cloud/v1
URL: https://api.hetzner.cloud/v1/datacenters
Auth: HTTP bearer

Query parameters

namestring

Filter resources by their name.

The response will only contain the resources matching exactly the specified name.

sortstring[]

Sort resources by field and direction. May be used multiple times.

For more information, see "Sorting".

pageinteger

Example:1

Page number to return. For more information, see "Pagination".

per_pageinteger

Example:25

Maximum number of entries returned per page. For more information, see "Pagination".

Response

Request succeeded.

recommendationinteger required

This field is deprecated. Use the recommended flag in the Server Type locations field instead (server_type.locations[].recommended).

Recommended Data Center for creating new resources.

Example response

{
  "datacenters": [
    {
      "id": 42,
      "name": "fsn1-dc8",
      "description": "Falkenstein DC Park 8",
      "location": {
        "id": 42,
        "name": "fsn1",
        "description": "Falkenstein DC Park 1",
        "country": "DE",
        "city": "Falkenstein",
        "latitude": 50.47612,
        "longitude": 12.370071,
        "network_zone": "eu-central"
      },
      "server_types": {
        "supported": [
          1,
          2,
          3
        ],
        "available": [
          1,
          2,
          3
        ],
        "available_for_migration": [
          1,
          2,
          3
        ]
      }
    }
  ],
  "recommendation": 1,
  "meta": {
    "pagination": {
      "page": 3,
      "per_page": 25,
      "previous_page": 2,
      "next_page": 4,
      "last_page": 4,
      "total_entries": 100
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.