API Reference · Early access
Nxeon API docs
A small, standard REST API. Authenticate with a scoped bearer token and read your fleet over HTTP. Write endpoints are rolling out: this page tracks exactly what’s live today.
Everything lives under /api/v1
https://nxeon.cloud/api/v1
All responses are JSON. Send and expect application/json.
Scoped bearer tokens
Create an API token in your dashboard under Settings → API tokens. Each token carries only the scopes you grant it, and you can revoke it any time. Pass it as a bearer token on every request:
$ curl https://nxeon.cloud/api/v1/servers \
-H "Authorization: Bearer nxe_live_xxxxxxxxxxxxxxxx"
401Unauthorized: a missing or invalid token.403Forbidden: a token without the required scope.GET/api/v1/servers
Lists the servers owned by the authenticated account. Requires the servers:read scope (tokens with no scopes have full read access). Returns the same data you see in the dashboard.
{
"data": [
{
"id": "srv_8fk21a",
"hostname": "web-prod-01",
"status": "RUNNING",
"plan": "standard",
"ipAddress": "51.79.226.200",
"createdAt": "2026-07-24T09:41:00Z"
}
]
}
On the roadmap
These endpoints are in progress and will appear here as they ship:
- POST
/api/v1/serverscreate a server (servers:write) - GET
/api/v1/servers/:idinspect a single server - POST
/api/v1/servers/:id/actionsstart, stop, reinstall, resize - …
Block-storage volume endpoints(storage:write) - GET
/api/v1/billingwallet balance & usage (billing:read)
Deploy your first server in under a minute
Creating an account is free and takes no card details. You pay when you deploy: choose a billing term and pay from your wallet or by card at checkout.