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

# Get balance statement

`GET /billing/balance/statement`

## Request

- Base URL: `https://api.axilio.ai/api/v1`
- URL: `https://api.axilio.ai/api/v1/billing/balance/statement`
- Auth: API key in header `X-Axilio-Api-Key`
- TypeScript: <https://skmtc.dev/axilioai/apis/axilio-api-2/docs/billing/balance/statement/get.ts> (a function with typed inputs; its response is checked against the schema)

The organization's balance over a period, like a bank statement: the starting balance, credit added, what each product used, credit taken back by refunds and chargebacks, credit that expired, and the ending balance.

## Query parameters

- `period_start_at` string, date-time, required: start of the period (RFC 3339)
- `period_end_at` string, date-time, required: end of the period, exclusive (RFC 3339)

## Response `200`

OK

- SubscriptionBalanceStatement: The organization's balance over a period, like a bank statement: where it started, what moved it, and where it ended. The lines add up: starting + added + each usage amount + refunded + expired + other = ending.
  - `added_microdollars` integer, required: Credit added in microdollars: top-ups, auto-recharge, plan credit and adjustments.
  - `ending_balance_microdollars` integer, required: Balance in microdollars at the end of the period.
  - `expired_microdollars` integer, required: Purchased credit that expired and plan credit that lapsed, in microdollars (zero or negative).
  - `other_microdollars` integer, required: Negative adjustments and balance corrections, in microdollars.
  - `period_end_at` string, date-time, required: End of the period (exclusive).
  - `period_start_at` string, date-time, required: Start of the period.
  - `refunded_microdollars` integer, required: Credit taken back by refunds and chargebacks, net of chargebacks won, in microdollars. Usually negative; positive when chargebacks won in the period exceed what was taken back.
  - `starting_balance_microdollars` integer, required: Balance in microdollars at the start of the period.
  - `usage` SubscriptionBalanceStatementUsage[], nullable, required: What each product used in the period, costliest first.
    - `amount_microdollars` integer, required: What they cost in microdollars (negative).
    - `count` integer, required: How many were billed (sessions or inference calls).
    - `product` string, required: The product: session or inference.

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-10-24** `ecca093572e0`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/axilioai/apis/axilio-api-2.md) - [All operations](https://skmtc.dev/axilioai/apis/axilio-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/axilioai/apis/axilio-api-2/revisions/62aa324803a7?raw)