API

Account

Updated November 15, 2026

On this page

Get the account

GET /account

Ability: account:read.

Who the token belongs to, what is on the balance and how many more servers can be ordered on each billing period.

Shell
curl https://panel.hostoff.net/api/v1/account \
  -H "Authorization: Bearer hostoff_your_token" \
  -H "Accept: application/json"
JSON
{
  "data": {
    "id": 1042,
    "name": "Example Ltd",
    "email": "ops@example.com",
    "default_currency": "EUR",
    "balances": [
      {"currency": "EUR", "amount": "25.00000000"},
      {"currency": "USD", "amount": "0.00000000"}
    ],
    "billing_limits": [
      {"period": "hourly", "name": "1 hour", "limit": 2, "used": 0, "available": 2},
      {"period": "monthly", "name": "1 month", "limit": 10, "used": 3, "available": 7},
      {"period": "yearly", "name": "1 year", "limit": null, "used": 1, "available": null}
    ]
  }
}
Field Meaning
default_currency the currency of the account
balances one entry per currency, zero and negative included. A negative amount means the account is on credit
billing_limits per billing period: how many active servers the account may have (limit), how many it has (used) and how many more can be ordered (available). null means no limit on that period

Before you order or renew

Orders, renewals and other paid actions are charged from the balance at once. Check two things first:

  • the balance in the server's currency covers the price, otherwise the answer is 402 insufficient_funds;
  • for an order, available of the chosen billing period is above zero (or null), otherwise the answer is 409 limit_reached.

The balance is topped up in the panel only. If you need higher limits, contact support.

Questions about the API?

Our support team will help with integration and access.

Contact support