API

Account

Оновлено 15 листопада 2026

Цю сторінку ще не перекладено вашою мовою, тому показано англійську версію.

На цій сторінці

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.

Питання щодо API?

Підтримка допоможе з інтеграцією та доступом.

Написати в підтримку