---
title: "Get account balance"
method: GET
path: "/billing/balance"
tags: ["billing"]
---

# Get account balance

`GET /billing/balance`

Returns the organization's current credit balance in microdollars plus a display string.

## Response `200`

OK

- SubscriptionBalanceResponse — The current account balance and its source breakdown.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `balance_display` string, required — Formatted balance string (e.g., '$12.50').
  - `balance_microdollars` integer, required — Current balance in microdollars (1_000_000 = $1.00).
  - `included_microdollars` integer, required — Remaining plan-included credit in microdollars. Spent first; resets to the plan allowance at each renewal.
  - `purchased_microdollars` integer, required — Remaining purchased credit in microdollars. Spent after included credit; each purchase expires one year after Stripe settled it.
  - `purchased_next_expiry` string, date-time — When the soonest-expiring purchased credit stops being usable.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.net/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/4a74befa0bde/schema)