Developer API

Automate everything.
Programmatically.

REST API for managing services, domains, DNS, invoices, and support tickets. JSON in, JSON out. Bearer-token auth. Versioned, stable, and documented to OpenAPI 3.1.

Quickstart OpenAPI spec ↓

Base URL: https://api.hostingdon.com/v1

Quickstart

Make your first call in 90 seconds.

Generate an API token in Settings → API Tokens, then make a request:

# List your active services
curl https://api.hostingdon.com/v1/services \
  -H "Authorization: Bearer hd_live_a1b2c3..." \
  -H "Accept: application/json"

Response:

{
  "data": [
    {
      "id": "svc_8f3a2b1c",
      "type": "web_hosting",
      "plan": "premium",
      "domain": "example.com",
      "status": "active",
      "datacenter": "fra1",
      "created_at": "2026-02-14T09:23:11Z",
      "next_due": "2026-06-14"
    }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 1 }
}

Authentication

Bearer tokens, scoped properly.

Every request requires an Authorization: Bearer <token> header. Tokens are scoped per-permission (read-only, services, domains, billing, full) and can be IP-restricted.

hd_live_*

Live token

Production. Real money, real changes. Rotate every 90 days.

hd_test_*

Sandbox token

Free sandbox account. Idempotent. Reset weekly.

Endpoints

Core resources, at a glance.

Every resource follows REST conventions: list (GET), retrieve (GET /:id), create (POST), update (PATCH), delete (DELETE). Full reference in the OpenAPI spec.

Services

GET/v1/servicesList all services

GET/v1/services/{id}Retrieve a service

POST/v1/servicesProvision a new service

PATCH/v1/services/{id}Upgrade or modify plan

DEL/v1/services/{id}Cancel a service

Domains

GET/v1/domainsList domains

GET/v1/domains/checkCheck availability + price

POST/v1/domainsRegister a domain

POST/v1/domains/{id}/transferInitiate inbound transfer

DNS Records

GET/v1/domains/{id}/dnsList DNS records

POST/v1/domains/{id}/dnsCreate A/CNAME/MX/TXT record

PATCH/v1/dns/{id}Update record

DEL/v1/dns/{id}Delete record

Invoices & Tickets

GET/v1/invoicesList invoices, filter by status

GET/v1/invoices/{id}/pdfDownload invoice as PDF

GET/v1/ticketsList support tickets

POST/v1/ticketsOpen a new support ticket

Rate limits

Generous limits. No surprises.

Limits are per-token and reset every minute. Every response includes X-RateLimit-Remaining and X-RateLimit-Reset headers.

600/min

Read endpoints

120/min

Write endpoints

30/min

Provisioning calls

∞

Need higher limits? Email us.

SDKs

Official libraries in five languages.

All MIT-licensed, all on GitHub. Auto-generated from the OpenAPI spec, hand-polished by humans.

PHP

hostingdon-php

composer require hostingdon/sdk

Node.js

hostingdon-node

npm i @hostingdon/sdk

Python

hostingdon-python

pip install hostingdon

hostingdon-go

go get hostingdon.com/sdk

Ruby

hostingdon-ruby

gem install hostingdon

Webhooks

Get pinged when things change.

Configure webhook endpoints in your dashboard. Events are signed with HMAC-SHA256, retried with exponential backoff on 5xx, and stored for 30 days for replay.

service.provisioned service.suspended domain.transferred invoice.paid invoice.overdue ticket.replied

Error codes

Code

Meaning

200

OK — success

201

Created — resource provisioned

400

Bad Request — invalid params, see errors[] in body

401

Unauthorized — missing or invalid token

403

Forbidden — token lacks scope for this action

404

Not Found — resource doesn't exist

429

Rate limited — back off, see Retry-After

5xx

Our problem — retry with exponential backoff

Ready to build

Generate your first token
in two clicks.

Free sandbox account. No credit card. Stable v1 API since 2019. Public changelog. We email three months ahead before any breaking change.

Get an API token View on GitHub

Automate everything.Programmatically.