> For the complete documentation index, see [llms.txt](https://developers.usetoggle.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.usetoggle.com/partner-guides/epos-and-ordering/balance-check.md).

# Balance check

To check a card balance, pass in the `card_reference` to the `Cards` query.

{% tabs %}
{% tab title="API call" %}

```graphql
query Cards {
    Cards(card_reference: "6301190004871637839") {
        data {
            card_reference
            balance
            card_alias_card_reference
            initial_balance
            product_name
            created_at
            used
            expiry_time
            validity_start_time
        }
    }
}
```

{% endtab %}
{% endtabs %}

### If no cards are found

If no cards are found for your query, the API will respond with blank JSON for “Data”:

```javascript
{
    "data": {
        "Cards": {
            "data": []
        }
    },
    "extensions": {
        "cost": {
            "actualQueryCost": 16,
            "throttleStatus": {
                "maximumAvailable": 8000,
                "currentlyAvailable": 7986
            }
        }
    }
}
```