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

# Get Account Balances

> Retrieve balance information for a specific account

## Path Parameters

<ParamField path="customer_id" type="string" required>
  The customer's external ID (starts with `cus_`)
</ParamField>

<ParamField path="account_id" type="string" required>
  The account's external ID (starts with `acc_`)
</ParamField>

## Response

<ResponseField name="id" type="string">
  Account identifier (starts with `acc_`)
</ResponseField>

<ResponseField name="object" type="string">
  Always returns `"account_balances"`
</ResponseField>

<ResponseField name="balances" type="array">
  Array of balance objects for each currency

  <Expandable title="Balance Fields">
    <ResponseField name="currency" type="string">
      ISO 4217 currency code
    </ResponseField>

    <ResponseField name="currency_type" type="string">
      Type of currency: `fiat` or `crypto`
    </ResponseField>

    <ResponseField name="available_balance" type="string">
      Amount available for immediate transactions (decimal string)
    </ResponseField>

    <ResponseField name="pending_payout" type="string">
      Amount tied up in pending outgoing transfers (decimal string)
    </ResponseField>

    <ResponseField name="pending_payin" type="string">
      Amount expected from pending incoming transfers (decimal string)
    </ResponseField>

    <ResponseField name="total_balance" type="string">
      Total balance including pending amounts (decimal string)
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of last balance update
    </ResponseField>
  </Expandable>
</ResponseField>

## Response Example

```json theme={null}
{
  "id": "acc_1234567890abcdef",
  "object": "account_balances",
  "balances": [
    {
      "currency": "USD",
      "currency_type": "fiat",
      "available_balance": "10000.50",
      "pending_payout": "250.00",
      "pending_payin": "500.00",
      "total_balance": "10750.50",
      "updated_at": "2024-01-15T12:30:00Z"
    },
    {
      "currency": "EUR",
      "currency_type": "fiat",
      "available_balance": "5000.25",
      "pending_payout": "0.00",
      "pending_payin": "100.00",
      "total_balance": "5100.25",
      "updated_at": "2024-01-14T08:00:00Z"
    }
  ]
}
```