API

API reference

Private beta

A small REST API for managing customers, services, and domains programmatically. Currently rolled out to partner agencies on request — email us to enable.

Request API access →

Base URL

https://opshosts.com/api/v1

Authentication

All requests require a Bearer token in the Authorization header. Tokens are scoped to a single agency and rotated on demand from your portal.

curl -H "Authorization: Bearer $OPSHOSTS_API_KEY" \
  https://opshosts.com/api/v1/customers

Resources

/customers — list, create, suspend
/services — provision, cancel, list
/domains — search, register, manage DNS
/orders — invoices and payment history
/webhooks — register endpoints for lifecycle events

Webhooks

Subscribe to events delivered as signed JSON POSTs:

customer.created · customer.suspended · customer.deleted
service.activated · service.suspended · service.terminated
domain.registered · domain.expiring · domain.transferred
order.paid · order.refunded · order.failed

Verify the signature with HMAC-SHA256 on the raw body using your webhook secret.

Rate limits

120 requests per minute per token. Burst up to 300. 429 with Retry-After on overage.