API Reference

Hostinvo REST API

Integrate, extend, and automate Hostinvo with the REST API.

Base URL: https://api.hostinvo.dev/api/v1

Auth: Bearer token (Sanctum)

Authentication: Send Bearer token in Authorization header: Bearer {token}. Obtain via POST /api/v1/auth/login.

MethodEndpointDescription

POST/api/v1/auth/loginAuthenticate and receive access token

POST/api/v1/auth/provider-registerRegister a new provider account and tenant

GET/api/v1/auth/onboarding/statusRetrieve onboarding step completion status

GET/api/v1/clientsList all clients for the authenticated tenant

POST/api/v1/clientsCreate a new client record

GET/api/v1/invoicesList invoices with filters (status, date range)

POST/api/v1/invoicesCreate a new invoice

POST/api/v1/invoices/{id}/payTrigger payment for an invoice

GET/api/v1/servicesList provisioned services

POST/api/v1/services/{id}/suspendSuspend a service (queues provisioning job)

POST/api/v1/services/{id}/terminateTerminate a service

GET/api/v1/serversList configured provisioning servers

POST/api/v1/servers/{id}/testTest server connectivity

POST/api/v1/licensing/validateValidate a license key and domain binding

POST/api/v1/licensing/activateActivate a license for an instance

GET/healthPlatform health aggregate check

GET/metricsPrometheus-format metrics (auth required)

Looking for integration guides?