Balance, credits, and invoices

Check the balance

Dashboard
CLI
Python SDK
Go SDK
REST API

Open Billing after choosing your organization. The balance card separates included and purchased credit.

axilio billing balance
axilio billing balance -o json

balance = client.billing.get_balance()

print(balance.balance_display)
print(balance.included_microdollars)
print(balance.purchased_microdollars)
print(balance.purchased_next_expiry)

balance, err := api.Billing.GetBalance(ctx)
if err != nil {
    log.Fatal(err)
}
fmt.Println(balance.BalanceDisplay)

REST API References:

Get account balance: GET /billing/balance

Examples use Bash. To run them in PowerShell, see Run the curl examples on Windows.

curl --silent --show-error --fail-with-body \
  --url https://api.axilio.ai/api/v1/billing/balance \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

How credits work

Axilio applies credits and charges using these rules:

Included credit is spent first. Axilio spends your current period’s free allowance before using any purchased credit. This ensures any purchases of additional credit are never wasted.
Included credit resets instead of accumulating. At renewal, any unused included credit lapses. The new period begins with exactly the new allowance.
Purchased credits are only spent after any included credits are spent. Top-ups and automatic recharges create separate purchased lots. When more than one lot remains, Axilio spends the lot with the soonest expiration first (FIFO) to minimize expired credits.
Each purchased lot expires one year after settlement. The one-year clock begins when Stripe settles that purchase. Unused credit in that lot is removed at expiration.
Automatic recharge restores your balance to the amount you configure. It is not a separate credit bucket. When your total balance falls below the configured Threshold, Axilio purchases enough credit to reach the configured Recharge to amount. That purchase then follows the same debt-first and expiration rules.
New credit repays debt first. If your balance is negative, a grant or purchase first reduces that deficit. Only the remainder becomes spendable credit. For example, a $10 top-up against a -$1 balance leaves $9 available.

The balance shown in the dashboard is the combined amount available after these rules are applied. The GET /billing/balance response exposes the same result as separate fields:

balance_microdollars is the combined balance. It can be negative when charges exceed the available credit.
included_microdollars is the unused included credit in the current period.
purchased_microdollars is the total remaining purchased credit across all unexpired lots.
purchased_next_expiry is the expiration time of the purchased lot that expires next. It is empty when no purchased credit remains.

When balance_microdollars is negative, both live-credit fields are zero. The next grant or purchase repays that deficit before adding spendable credit. Dedicated-phone rental charges are separate from these credit buckets. A dedicated session does not consume phone-time credit, but metered vision calls during that session can consume the balance. See Dedicated phone pricing for rental periods and Models and pricing for metered inference pricing. Axilio does not provide a routine self-service refund path. Contact support if you believe a purchase or charge requires review.

See how credit moves through each bucket

Add funds

Adding funds and managing payment methods are dashboard-only actions:

Open Billing.
Click Add Funds.
Choose an amount and complete checkout.

The CLI, SDKs, and public REST API do not create an add-funds checkout or customer-portal session.

List and download invoices

Dashboard
Python SDK
Go SDK
REST API

Open Billing, select Invoices, filter the list, then click PDF on the invoice you need.

history = client.billing.get_history(limit=20, offset=0)

for invoice in history.items or []:
    print(invoice.id, invoice.invoice_number, invoice.status)

pdf = client.billing.download_invoice("inv_123")
print(pdf.download_url, pdf.expires_at)

history, err := api.Billing.GetHistory(ctx, &platformgo.BillingGetHistoryRequest{
    Limit:  platformgo.Int64(20),
    Offset: platformgo.Int64(0),
})

pdf, err := api.Billing.DownloadInvoice(ctx, &platformgo.BillingDownloadInvoiceRequest{
    InvoiceID: "inv_123",
})
fmt.Println(pdf.DownloadURL, pdf.ExpiresAt)

REST API References:

List billing history: GET /billing/history
Get an invoice PDF URL: GET /billing/history/{invoice_id}/pdf

Examples use Bash. To run them in PowerShell, see Run the curl examples on Windows.

curl --silent --show-error --fail-with-body \
  --url "https://api.axilio.ai/api/v1/billing/history?limit=20&offset=0" \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

curl --silent --show-error --fail-with-body \
  --url https://api.axilio.ai/api/v1/billing/history/inv_123/pdf \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

The CLI does not currently list or download invoices. A PDF URL is temporary; request a fresh one instead of storing it.

Configure automatic recharge

Automatic recharge charges the saved payment method when the balance falls below a threshold, restoring it to a target amount. Adding the payment method itself remains a dashboard action.

Dashboard
Python SDK
Go SDK
REST API

Open Billing, select Preferences, then find Auto-recharge. If you are an organization admin, you can:

Add or update the saved card through Manage payment method.
Set Threshold to the balance that triggers a recharge.
Set Recharge to to the balance Axilio should restore.
Turn on Automatically top up. Enabling it saves the amounts shown.

If auto-recharge is already on, select Save after changing either amount without toggling it off.The recharge target must be at least $5 and greater than the threshold. If you are not an administrator, you can view the current state but cannot change it.

settings = client.billing.get_auto_recharge()

updated = client.billing.update_auto_recharge(
    enabled=True,
    threshold_cents=500,
    target_cents=2500,
)

settings, err := api.Billing.GetAutoRecharge(ctx)

updated, err := api.Billing.UpdateAutoRecharge(
    ctx,
    &platformgo.SubscriptionAutoRechargeSettings{
        Enabled:        true,
        ThresholdCents: 500,
        TargetCents:    2500,
    },
)

REST API References:

Get auto-recharge settings: GET /billing/auto-recharge
Update auto-recharge settings: PUT /billing/auto-recharge

Examples use Bash. To run them in PowerShell, see Run the curl examples on Windows.

curl --silent --show-error --fail-with-body \
  --url https://api.axilio.ai/api/v1/billing/auto-recharge \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

curl --silent --show-error --fail-with-body \
  --request PUT \
  --url https://api.axilio.ai/api/v1/billing/auto-recharge \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "enabled": true,
    "threshold_cents": 500,
    "target_cents": 2500
  }'

The CLI does not configure automatic recharge; its billing commands are read-only.

Configure low-balance alerts

Low-balance alerts warn you before insufficient funds can block a session. Negative-balance alerts are separate, always enabled, and cannot be turned off.

Dashboard
CLI
Python SDK
Go SDK
REST API

Open Billing, select Preferences, then find Usage alerts. If you are an organization admin, you can:

Set Alert threshold to a positive dollar amount.
Turn on Low-balance alert. Enabling it saves the threshold shown.

If the alert is already on, select Save after changing the threshold. If you are not an administrator, you can view its current state but cannot change it.

The CLI does not currently read or configure low-balance alerts. Its relevant command is axilio billing balance.

alerts = client.billing.get_usage_alerts()
print(alerts.enabled, alerts.threshold_cents)

updated = client.billing.update_usage_alerts(
    enabled=True,
    threshold_cents=1000,
)

alerts, err := api.Billing.GetUsageAlerts(ctx)
if err != nil {
    log.Fatal(err)
}
fmt.Println(alerts.Enabled, alerts.ThresholdCents)

updated, err := api.Billing.UpdateUsageAlerts(
    ctx,
    &platformgo.SubscriptionUsageAlertSettings{
        Enabled:        true,
        ThresholdCents: 1000,
    },
)
if err != nil {
    log.Fatal(err)
}
fmt.Println(updated.Enabled, updated.ThresholdCents)

REST API References:

Get usage-alert settings: GET /billing/usage-alerts
Update usage-alert settings: PUT /billing/usage-alerts

Examples use Bash. To run them in PowerShell, see Run the curl examples on Windows.

curl --silent --show-error --fail-with-body \
  --url https://api.axilio.ai/api/v1/billing/usage-alerts \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

curl --silent --show-error --fail-with-body \
  --request PUT \
  --url https://api.axilio.ai/api/v1/billing/usage-alerts \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "enabled": true,
    "threshold_cents": 1000
  }'

Updating auto-recharge or alerts requires an organization admin. An API key inherits its creator’s organization role.

Get Started

Phones and Sessions

Workflows and Runs

Files

Observability

Telemetry

Usage

Billing

Organization

Reference

Balance, credits, and invoices

Check the balance

How credits work

Add funds

List and download invoices

Configure automatic recharge

Configure low-balance alerts

​Check the balance

​How credits work

​Add funds

​List and download invoices

​Configure automatic recharge

​Configure low-balance alerts

Check the balance

How credits work

Add funds

List and download invoices

Configure automatic recharge

Configure low-balance alerts