> ## Documentation Index
> Fetch the complete documentation index at: https://docs.machines.cash/llms.txt
> Use this file to discover all available pages before exploring further.

# Balances

> Fetch spending power and charge totals.

## Overview

* <code>GET /balances</code> returns credit limit, spending power, and charge totals (all in cents).
* No extra scopes are required.

## API flow (step‑by‑step)

<Steps>
  <Step title="Fetch balances">
    <b>Endpoint</b>: <a href="/api/balances/get" target="_blank" rel="noreferrer"><code>GET /balances</code></a><br />
    <b>Headers</b>: <code>Authorization: Bearer \<SESSION\_TOKEN></code>

    ```bash theme={null}
    curl -s \
      -H "Authorization: Bearer $SESSION_TOKEN" \
      https://dev-api.machines.cash/partner/v1/balances
    ```

    Use the returned values to display available spend and current charge totals.
  </Step>
</Steps>

## Response (balances)

<ResponseField name="balances.spendingPower" type="number">
  Available spending power in cents.
</ResponseField>

<ResponseField name="balances.creditLimit" type="number">
  Credit limit in cents.
</ResponseField>

<ResponseField name="balances.pendingCharges" type="number">
  Pending charges in cents.
</ResponseField>

<ResponseField name="balances.postedCharges" type="number">
  Posted charges in cents.
</ResponseField>

<ResponseField name="balances.balanceDue" type="number">
  Balance due in cents.
</ResponseField>