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

# Get balance statement

`GET /billing/balance/statement`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/billing/balance/statement`
- Auth: API key in header `X-Axilio-Api-Key`
- TypeScript: <https://skmtc.dev/axilioai/apis/axilio-api/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.
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `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-23** `49b1da5a7974`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axilioai/apis/axilio-api/changes/billing/balance/statement/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.dev/axilioai/apis/axilio-api/revisions/80de09d0e643?raw)