Get the account
GET /accountAbility: 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,
availableof the chosen billing period is above zero (ornull), otherwise the answer is409 limit_reached.
The balance is topped up in the panel only. If you need higher limits, contact support.