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

# Account Balance Inquiry

> Query the current balance of your account for one or all supported currencies.

```
POST https://{baseUrl}/api/sp2401
```

### Request Parameters

<ParamField body="currency" type="string">
  ISO 4217 3-letter currency code (e.g. `USD`). Omit this field to retrieve balances for all currencies.
</ParamField>

### Response Body

The response returns a list of **CurrencyBalance** objects.

<ResponseField name="CurrencyBalance[]" type="object[]" required>
  List of account balances, one entry per currency.

  <Expandable title="properties">
    <ResponseField name="currency" type="string" required>
      ISO 4217 3-letter currency code (e.g. `USD`).
    </ResponseField>

    <ResponseField name="balance" type="string" required>
      Available account balance for the given currency.
    </ResponseField>

    <ResponseField name="status" type="string" required>
      Account status:

      * `on` — Enabled
      * `off` — Disabled
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "currency": "USD"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "currency": "USD",
      "balance": "2000.00",
      "status": "on"
    },
    {
      "currency": "CNY",
      "balance": "8231.22",
      "status": "off"
    }
  ]
  ```
</ResponseExample>