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

## Changes

- **2026-08-20** `4a74befa0bde` — 3 info
  - added the optional property `purchased_next_expiry` to the response with the `200` status
  - added the required property `included_microdollars` to the response with the `200` status
  - added the required property `purchased_microdollars` to the response with the `200` status
- **2026-08-17** `e2261ff54e62` — 1 info
  - the endpoint scheme security `bearerAuth` was removed from the API
- **2026-06-29** `206b42a858c3` — 1 info
  - api operation id `billing-get-balance` removed and replaced with `billing_get_balance`

[Change history](https://skmtc.dev/axilioai/apis/axilio-api/changes/billing/balance/get.md)

---

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