API overview
REST API basics for automating accounts, services, and domains on OpenHost.
The OpenHost API is a REST JSON API for staff automation and integrators. It mirrors operations available in the client area and control panel.
Base URL
All requests use HTTPS:
https://billing.openhost.one/api/admin/
Server-to-server calls from OpenHost infrastructure may use loopback with a Host: billing.openhost.one header. External callers must use the public hostname.
Authentication
Send a bearer token on every request:
curl -s https://billing.openhost.one/api/admin/client/get_list \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"See Authentication for token rotation and scope lists.
Response shape
Successful responses return JSON with a result payload. Errors include error code and message:
{
"error": {
"message": "Authentication Failed",
"code": 401
}
}Common resources
/api/admin/client/get_listList client accounts with pagination.
/api/admin/client/{id}Fetch a single client record.
/api/admin/support/ticket_createOpen a support ticket on behalf of a client.
/api/admin/servicehosting/get_listList active hosting services and package bindings.
Rate limits
- 120 requests/minute per token burst
- 429 response with
Retry-Afterheader when exceeded - Idempotent GETs are safe to retry; POST writes should use client-supplied idempotency keys where documented
Webhooks
Subscribe to invoice paid, service activated, and ticket opened events. Payloads are signed with HMAC-SHA256. Details in Webhooks.
SDKs
No official SDK yet. The API follows FOSSBilling admin conventions. Community wrappers may exist; verify they target API version 0.8.x.