Developer documentation | Sections Test

Guides, API reference, SDKs, tutorials, and support resources to integrate, build, and scale with our platform.

Browse by category

Guides

DCD workflows, onboarding, and core concepts.

API Reference

Endpoints, schemas, and authentication details.

SDK & Tools

Client libraries, CLIs, and helpers.

Tutorials

Step-by-step guides and code samples.

Partner Portal (Coming soon)

Partner resources and integrations. Launching soon.

Support & FAQs

Troubleshooting, common questions, and support.

Get started in 5 minutes

Setting up your first API call should be the easiest part of getting started. With clear endpoints, copy-paste-ready examples, and quick authentication, you’ll be up and running in minutes, not hours.

No guesswork, no complexity, just your first successful call, fast.

Get started API reference SDKs & tools

The examples below call the Cloud API: GET /cloudapi/v6/datacenters.

Quick test (cURL)

# Credentials for Basic auth (username + password)
export IONOS_USERNAME="your-username"
export IONOS_PASSWORD="your-password"

# 1) Generate an access token
export IONOS_ACCESS_TOKEN="$(
  curl --silent --request GET "https://api.ionos.com/auth/v1/tokens/generate" \
    --user "$IONOS_USERNAME:$IONOS_PASSWORD" \
  | jq -r '.token'
)"

# 2) Make your first request
curl --request GET "https://api.ionos.com/cloudapi/v6/datacenters" \
  --header "Authorization: Bearer $IONOS_ACCESS_TOKEN"

This snippet uses jq to extract the token. Install it or parse JSON manually.

SDK examples

All SDK examples assume you have already IONOS_ACCESS_TOKEN exported.

Node.js

index.mjs

const res = await fetch("https://api.ionos.com/cloudapi/v6/datacenters", {
  headers: { Authorization: `Bearer ${process.env.IONOS_ACCESS_TOKEN}` },
});

if (!res.ok) throw new Error(await res.text());
console.log(await res.json());

main.go

package main

import (
  "io"
  "net/http"
  "os"
  "fmt"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.ionos.com/cloudapi/v6/datacenters", nil)
  req.Header.Set("Authorization", "Bearer "+os.Getenv("IONOS_ACCESS_TOKEN"))

  res, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer res.Body.Close()

  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

Python

main.py

import os
import requests

res = requests.get(
  "https://api.ionos.com/cloudapi/v6/datacenters",
  headers={"Authorization": f"Bearer {os.environ['IONOS_ACCESS_TOKEN']}"},
)
res.raise_for_status()
print(res.json())

Java

Main.java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
  public static void main(String[] args) throws Exception {
    String token = System.getenv("IONOS_ACCESS_TOKEN");

    HttpRequest req = HttpRequest.newBuilder()
      .uri(URI.create("https://api.ionos.com/cloudapi/v6/datacenters"))
      .GET()
      .header("Authorization", "Bearer " + token)
      .build();

    HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
    System.out.println(res.body());
  }
}

Ruby

main.rb

require "net/http"
require "uri"

token = ENV.fetch("IONOS_ACCESS_TOKEN")
uri = URI("https://api.ionos.com/cloudapi/v6/datacenters")

req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer #{token}"

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

NextPartner Portal (Coming soon)

Good night

hashtagBrowse by category

hashtagbook-blank

hashtagGuides

hashtagcode

hashtagAPI Reference

hashtagwrench

hashtagSDK & Tools

hashtaguser-graduate

hashtagTutorials

hashtagusers

hashtagPartner Portal (Coming soon)

hashtagmessage-question

hashtagSupport & FAQs

hashtagGet started in 5 minutes

hashtagSDK examples

Browse by category

Guides

API Reference

SDK & Tools

Tutorials

Partner Portal (Coming soon)

Support & FAQs

Get started in 5 minutes

SDK examples