> ## Documentation Index
> Fetch the complete documentation index at: https://api.scalysis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get balance

> Check your wallet before sending calls.

Returns your wallet. Check it before sending a large batch, so calls don't stop halfway.

Calls stop with `402` when `remainingBeforeCreditLimit` reaches `0`. See [Limits & rules](https://api.scalysis.com/limits.md#balance).

```bash cURL theme={null}
curl https://app.scalysis.com/api/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json 200 theme={null}
{
  "success": true,
  "shopDomain": "yourstore.myshopify.com",
  "currentBalance": 2450.75,
  "creditLimit": 0,
  "addedBalance": 5000,
  "activeBillingPlan": "per_second_all",
  "remainingBeforeCreditLimit": 2450.75
}
```

```json 401 theme={null}
{ "success": false, "error": "Unauthorized" }
```

## Response

All amounts are in rupees (₹).

**currentBalance** `number`

Money in your wallet right now.

**creditLimit** `number`

The lowest your wallet can go. `0` means calls stop at ₹0. A negative number, like `-1000`, means your account can go ₹1000 below zero.

**remainingBeforeCreditLimit** `number`

What you can still spend: `currentBalance` minus `creditLimit`. **Use this one** to decide if you can send more calls.

**addedBalance** `number`

Total money added to the wallet so far.

**activeBillingPlan** `string`

Your billing plan.

**shopDomain** `string`

The account this API key belongs to.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.