curl --request GET \
--url https://sg.sandbox.api.reap.global/accounts/{id}/balance \
--header 'Authorization: Bearer <token>' \
--header 'Reap-Version: <reap-version>'const options = {
method: 'GET',
headers: {'Reap-Version': '<reap-version>', Authorization: 'Bearer <token>'}
};
fetch('https://sg.sandbox.api.reap.global/accounts/{id}/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sg.sandbox.api.reap.global/accounts/{id}/balance"
headers = {
"Reap-Version": "<reap-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"currency": "USD",
"totalAssetValue": 5000,
"totalLiabilities": 500,
"availableBalance": 4500,
"assets": {
"crypto": 5000,
"virtual": 2000
},
"liabilities": {
"cardDebt": {
"pending": 50,
"cleared": 450,
"total": 500
},
"depositFees": 12.5
}
}{
"error": {
"code": "ACCOUNT_NOT_FOUND",
"message": "<string>",
"detail": {}
}
}Get account balance
Retrieves the account financial position including total asset value, liabilities, and net available balance. Use GET /accounts/:id/assets for per-asset breakdown. All values are in the project’s billing currency (see the currency field).
curl --request GET \
--url https://sg.sandbox.api.reap.global/accounts/{id}/balance \
--header 'Authorization: Bearer <token>' \
--header 'Reap-Version: <reap-version>'const options = {
method: 'GET',
headers: {'Reap-Version': '<reap-version>', Authorization: 'Bearer <token>'}
};
fetch('https://sg.sandbox.api.reap.global/accounts/{id}/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sg.sandbox.api.reap.global/accounts/{id}/balance"
headers = {
"Reap-Version": "<reap-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"currency": "USD",
"totalAssetValue": 5000,
"totalLiabilities": 500,
"availableBalance": 4500,
"assets": {
"crypto": 5000,
"virtual": 2000
},
"liabilities": {
"cardDebt": {
"pending": 50,
"cleared": 450,
"total": 500
},
"depositFees": 12.5
}
}{
"error": {
"code": "ACCOUNT_NOT_FOUND",
"message": "<string>",
"detail": {}
}
}Authorizations
API key as Bearer token
Headers
API version (YYYY-MM-DD)
2025-02-14 "2025-02-14"
Path Parameters
Account ID
Response
Account balance: total asset value, liabilities, and net position. In User-Funded projects and Program-Funded projects on Managed authorization, Reap authorizes each card transaction against these balances. Under External authorization this endpoint is not the authorization source: Reap holds no per-user asset balance, availableBalance reflects only Reap-side card debt and is not spendable, and your own ledger is authoritative.
Currency for all monetary values - the billing currency of the project's card program
"USD"
"HKD"
Sum of all asset values backing the account.
x >= 05000
Sum of all liabilities. Can be negative when refunds or settlement payments exceed outstanding card debt.
500
0
-25
Net balance: totalAssetValue - totalLiabilities. In User-Funded projects and Program-Funded projects on Managed authorization, this is the spendable figure the next card swipe is authorized against and the primary number to surface to cardholders. Not a spendable figure under External authorization - see the endpoint description.
4500
Breakdown of asset categories contributing to totalAssetValue
Show child attributes
Show child attributes
Breakdown of liability categories contributing to totalLiabilities
Show child attributes
Show child attributes