Shared HostingFirst month freeShared web hosting from $2.99/mo — $0 today, and the price you sign up at is the price you renew at.See hosting plans →
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.

Base URL

Everything lives under /api/v1

https://nxeon.cloud/api/v1

All responses are JSON. Send and expect application/json.

Authentication

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.

EndpointLive

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"
    }
  ]
}
Rolling out

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 server
  • POST /api/v1/servers/:id/actions — start, stop, reinstall, resize
  • Block-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.