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/v1All 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"A missing or invalid token returns 401 Unauthorized; a token without the required scope returns 403 Forbidden.
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/servers — create a server (servers:write)GET /api/v1/servers/:id — inspect a single serverPOST /api/v1/servers/:id/actions — start, stop, reinstall, resizeBlock-storage volume endpoints (storage:write)GET /api/v1/billing — wallet 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.