Check card balance

You can check the current balance available on a card using the Get card balance endpoint:

curl --request GET \
     --url https://api.gravv.xyz/v1/cards/<card id>/balance \
     --header 'Api-Key: <Api Key>'

You will receive a response showing the current balance:

{
  "data": {
    "balance": 22
  },
  "error": null
}

The balance is displayed in USD and represents the total funds available for card transactions.

When to check card balance

You can check the card balance:

  • before initiating large transactions to ensure sufficient funds
  • after funding the card to confirm funds were received
  • when reconciling accounts and transactions
  • to display the available balance to customers in your application
  • after withdrawals to verify the remaining balance