# Check your Weir credits with Python, Node.js and cURL

See how many credits your account has left before a large job. This call is free.

It is one call to [`GET /v1/usage`](/reference/account/getUsage), which costs nothing. Every snippet below ran against the live API on 27 October 2026, and the output is what the Python printed.

Set your key first. Create one at https://weirapp.io/dashboard/keys; every account gets 5,000 free credits a month.

```bash
export WEIR_API_KEY=weir_live_...
```

## Python

```python
import os

import requests

response = requests.get(
    "https://api.weirapp.io/v1/usage",
    headers={"Authorization": f"Bearer {os.environ['WEIR_API_KEY']}"},
    timeout=60,
)
response.raise_for_status()
page = response.json()

print(sorted(page["data"].keys()))
print("credits charged:", response.headers["X-Credits-Charged"])
```

## Node.js

```js
// Node.js 18 or later, as an ES module (save as example.mjs).
const response = await fetch("https://api.weirapp.io/v1/usage", {
  headers: { Authorization: `Bearer ${process.env.WEIR_API_KEY}` },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const page = await response.json();

console.log(Object.keys(page.data).sort());
console.log("credits charged:", response.headers.get("x-credits-charged"));
```

## cURL

```bash
curl --request GET \
  --url 'https://api.weirapp.io/v1/usage' \
  --header "Authorization: Bearer $WEIR_API_KEY"
```

## Output

```text
['available', 'balance', 'freeGrant', 'reserved', 'spendingPaused', 'tier']
credits charged: 0
```

## If a call fails

Failed calls are free. A `429` means too many requests a minute: wait the seconds in `Retry-After` and send it again. A `402` means the account is out of credits. A `503` means the source is busy and is safe to retry. Every code is on [Errors](/errors), and paging is on [Pagination](/pagination).