Skip to main content
GET
/
v1
/
customers
/
{customer_id}
/
accounts
/
{account_id}
/
balances
Get Account Balances
curl --request GET \
  --url https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}/balances \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "<string>",
  "balances": [
    {
      "currency": "<string>",
      "currency_type": "<string>",
      "available_balance": "<string>",
      "pending_payout": "<string>",
      "pending_payin": "<string>",
      "total_balance": "<string>",
      "updated_at": "<string>"
    }
  ]
}

​
Path Parameters

​
customer_id
string
required
The customer’s external ID (starts with cus_)
​
account_id
string
required
The account’s external ID (starts with acc_)

​
Response

​
id
string
Account identifier (starts with acc_)
​
object
string
Always returns "account_balances"
​
balances
array
Array of balance objects for each currency

​
Response Example

{
  "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"
    }
  ]
}