---
title: "Get card balance"
description: "Retrieve the current balance available on a card."
protocol: rest
method: GET
endpoint: "/v1/cards/{card_id}/balance"
baseUrl: "https://api.gravv.xyz"
group: "Cards"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Get card balance

<Endpoint method="GET" path="/v1/cards/{card_id}/balance" />

Retrieve the current balance available on a card.

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

## Path Parameters

<ParamField name="card_id" path="card_id" type="string" required>
  The ID of the card to retrieve balance for
</ParamField>

## Responses

| Status | Description |
| --- | --- |
| `200` | Card balance retrieved successfully |

### 200 response

<ResponseField name="data" type="object">

  <Expandable title="properties">
    <ResponseField name="balance" type="number">
      Current card balance
    </ResponseField>

    <ResponseField name="currency" type="string">
      Currency of the balance
    </ResponseField>

  </Expandable>
</ResponseField>

<ResponseField name="error" type="null">
</ResponseField>

<ResponseExample>

```json title="Response"
{
  "data": {
    "balance": 22,
    "currency": "USD"
  },
  "error": null
}
```

</ResponseExample>

## Authorization

- **ApiKeyAuth**