The prepaid balance
Spendable balance (expired credit excluded), credit expiring in 30 days, auto top-up and low-balance alert settings (the alert email starts once there is paid credit: a top-up), pricing, and welcome_credit: whether the €1 welcome credit was granted and, if not, why (card_already_used: it applies only once per card). pricing is pay_as_you_go for an account that signed up on or after 13 November 2026, or legacy_plan for one that signed up before: it keeps its plan and everything it includes, nothing is paid from a balance, the amounts are 0 and topup_url is null. A client company (Getbeel-Company) sees its gestore’s balance with billed_to_parent true. Usage, top-ups and card links answer 409 not_pay_as_you_go for a legacy_plan account.
Spendable balance (expired credit excluded), credit expiring in 30 days, auto top-up and low-balance alert settings (the alert email starts once there is paid credit: a top-up), pricing, and welcome_credit: whether the €1 welcome credit was granted and, if not, why (card_already_used: it applies only once per card). pricing is pay_as_you_go for an account that signed up on or after 13 November 2026, or legacy_plan for one that signed up before: it keeps its plan and everything it includes, nothing is paid from a balance, the amounts are 0 and topup_url is null. A client company (Getbeel-Company) sees its gestore’s balance with billed_to_parent true. Usage, top-ups and card links answer 409 not_pay_as_you_go for a legacy_plan account.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Getbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidOK
application/json- response
object*stringcurrency*stringbalance_cents*integerSpendable balance; below zero only because received SDI invoices are never blocked (down to -1000)
-9007199254740991 <= value <= 9007199254740991expiring_soon_cents*integerEUR cents, net of VAT
-9007199254740991 <= value <= 9007199254740991billed_to_parent*booleanpricing*stringpay_as_you_go: signed up on or after 13 November 2026; every billable action is paid from this balance. legacy_plan: signed up before; the account keeps its plan and everything it includes for life (tax filings and connected bank accounts too) and nothing is paid from a balance: the amounts are 0, topup_url is null, and usage, top-ups and card links answer 409 not_pay_as_you_go.
"pay_as_you_go""legacy_plan"auto_topup*low_balance_alert*welcome_credit*The €1 welcome credit of this billing account
topup_url*|The Billing & usage page to add credits; null on legacy_plan (no balance)
note*stringcurl -X GET 'https://www.getbeel.com/api/v1/billing/balance'{ "object": "balance", "currency": "EUR", "balance_cents": -9007199254740991, "expiring_soon_cents": -9007199254740991, "billed_to_parent": true, "pricing": "pay_as_you_go", "auto_topup": { "enabled": true, "threshold_cents": -9007199254740991, "amount_cents": -9007199254740991 }, "low_balance_alert": { "enabled": true, "threshold_cents": -9007199254740991 }, "welcome_credit": { "granted": true, "not_granted_reason": "card_already_used" }, "topup_url": "http://example.com", "note": "string"}