Skip to main content
GET
/
accounts
/
{id}
/
balance
Get account balance
curl --request GET \
  --url https://sandbox.api.reap.global/accounts/{id}/balance \
  --header 'Authorization: Bearer <token>' \
  --header 'Reap-Version: <reap-version>'
{
  "currency": "<string>",
  "totalAssetValue": 1,
  "totalLiabilities": 123,
  "availableBalance": 123,
  "assets": {
    "crypto": 5000,
    "virtual": 2000
  },
  "liabilities": {
    "cardDebt": {
      "pending": 123,
      "cleared": 123,
      "total": 123
    }
  }
}

Authorizations

​
Authorization
string
header
required

API key as Bearer token

Headers

​
Reap-Version
enum<string>
required

API version (YYYY-MM-DD)

Available options:
2025-02-14
Example:

"2025-02-14"

Path Parameters

​
id
string<uuid>
required

Account ID

Response

Account balance showing total asset value, liabilities, and net position

​
currency
string
required

Currency for all monetary values

Example:

"USD"

​
totalAssetValue
number
required

Sum of all asset values backing the account.

Required range: x >= 0
Example:

5000

​
totalLiabilities
number
required

Sum of all liabilities. Can be negative when refunds or settlement payments exceed outstanding card debt.

Examples:

500

0

-25

​
availableBalance
number
required

Net spendable balance: totalAssetValue - totalLiabilities. This is the primary field to surface to cardholders — it is exactly how much the next card swipe can authorize against. Most integrations only need this number; the per-category breakdown is for your own reporting.

Example:

4500

​
assets
object
required

Breakdown of asset categories contributing to totalAssetValue

​
liabilities
object
required

Breakdown of liability categories contributing to totalLiabilities