> For the complete documentation index, see [llms.txt](https://docs.cardspro.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cardspro.com/api/cards/user-account-balance.md).
# User Account Balance
Retrieves the balance of one or more user accounts by currency or account name.
**Endpoint:** `GET /account/balance`
**Query Parameters:**
Parameter
Type
Required
Default
Description
currency
String
No
-
Currency code (EUR, USD, etc.)
account
String
No
-
Specific account name
**Note:** If both parameters are provided, `account` takes precedence over `currency`.
**Response:**
```json
[
{
"total": 1234.56,
"currency": "USD"
},
{
"total": 5678.90,
"currency": "EUR"
}
]
```
**Response for Single Account Query:**
```json
[
{
"total": 1234.56,
"currency": "USD"
}
]
```
**Response Parameters:**
The endpoint returns an **array** of account balance objects: