Skip to main content
GET
Get prepaid credit
Required scope: PARTNER
Returns the prepaid credit you have left and your recent top-ups. Allo pays every partner charge from this credit first.

How partner charges are paid

Everything you buy for your accounts is paid the same way: new accounts, their renewals, extra numbers, member seats and eSIMs.
  1. Allo draws on your prepaid credit first.
  2. If the credit does not cover the whole charge, Allo charges the rest to the card on your billing account.
  3. If the credit does not cover the charge and you have no card on file, the request fails with 402 PARTNER_CREDIT_INSUFFICIENT. Nothing is created and nothing is charged.
When you pay a prepaid credit invoice, its amount before tax is added to your balance. To top up your credit, write to [email protected].

Response

  • balance_cents is the credit left, in the smallest unit of currency (cents for EUR and USD). It is 0 before your first top-up.
  • currency is lowercase, for example eur. It is absent before your first top-up.
  • prepaid is true once at least one top-up was added to your credit.
  • last_top_up is your most recent top-up: amount_cents, currency and at. It is absent when you have none.
  • top_ups lists your 20 most recent top-ups, newest first. Each one has amount_cents (before tax), currency, invoice_id and at.
Only Discounted licence (reseller) partners can read the credit. Any other partner gets PARTNER_CONTRACT_CANNOT_PROVISION, and an account that is not an enabled partner gets PARTNER_ACCESS_REQUIRED.

Authorizations

Authorization
string
header
required

Response

Your prepaid credit

data
object