GetbeelDocs

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.

GET
/billing/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.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Header Parameters

Getbeel-Company?string

Act 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.

Formatuuid

Response Body

OK

application/json
  1. response
object*string
currency*string
balance_cents*integer

Spendable balance; below zero only because received SDI invoices are never blocked (down to -1000)

Range-9007199254740991 <= value <= 9007199254740991
expiring_soon_cents*integer

EUR cents, net of VAT

Range-9007199254740991 <= value <= 9007199254740991
billed_to_parent*boolean
pricing*string

pay_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.

Value in"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*string
Example Request
curl -X GET 'https://www.getbeel.com/api/v1/billing/balance'
Example Response
{  "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"}