Skip to main content
GET
/
wallets
/
usd-balance
USD wallet balance
curl --request GET \
  --url https://api.cartevo.co/api/v1/wallets/usd-balance \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "balance": 175.5,
    "currency": "USD",
    "country": "United States"
  }
}

​
Overview

GET /wallets/usd-balance is a convenience endpoint that resolves your company’s USD wallet and returns its current balance. The USD wallet is the one used to issue and fund cards and to receive card-termination refunds.

​
When to use it

  • Check available USD funds before issuing or funding a card.
  • Display the USD balance in your dashboard without listing every wallet.
For the full per-wallet detail (sub-balances, lifetime volumes), use GET /wallets/{id} or GET /wallets.

​
Prerequisites

  • Your company must have a USD wallet.

​
Request

​
Headers

NameRequiredDescription
AuthorizationYesBearer <access_token>
This endpoint takes no path or query parameters — the USD wallet is resolved from your authenticated company.

​
Response

​
200 — Success

{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "walletId": "w1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "balance": 175.5,
    "currency": "USD",
    "country": "United States"
  }
}
data fields:
FieldTypeDescription
walletIdstringID of your company’s USD wallet (UUID)
balancenumberCurrent USD wallet balance
currencystringAlways "USD"
countrystringWallet country

​
Error responses

StatusTrigger
404No USD wallet exists for your company.

​
Code examples

cURL
curl https://api.cartevo.co/api/v1/wallets/usd-balance \
  -H "Authorization: Bearer $TOKEN"

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

The company's USD wallet balance.

​
success
boolean
Example:

true

​
statusCode
integer
Example:

200

​
message
string
Example:

"Data retrieved successfully"

​
data
object