---
title: "Get the credit balance"
method: GET
path: "/credits/balance"
tags: ["Credits"]
---

# Get the credit balance

`GET /credits/balance`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/credits/balance`
- Auth: HTTP bearer

Returns the workspace's credit wallet. A wallet is created empty on first use, so a new workspace sees zeros rather than an error; a workspace on a free trial sees its one-time trial credits, which its first balance read hands over. unlimited is true when Emailchaser has made this workspace's credits free: credit actions then never spend available and are never refused for lack of credits, so there is no need to check the balance or buy credits.

## Response `200`

The wallet snapshot

- ModelsCreditBalanceResponse
  - `available` integer
  - `lifetimeGranted` integer
  - `lifetimeUsed` integer
  - `monthlyGrant` integer
  - `reserved` integer
  - `unlimited` boolean: Unlimited is true when this workspace's credits are free: every credit action goes through without spending available, nothing is refused for lack of credits, and POST /credits/purchase is refused (code credits_free) because there is nothing to buy.

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `500`: Failed to load the credit balance

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)