---
title: "Get credit wallet balance and bundle pricing"
method: GET
path: "/api/public/v1/balance"
tags: ["Public API v1", "Public API v1"]
---

# Get credit wallet balance and bundle pricing

`GET /api/public/v1/balance`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/public/v1/balance`
- Auth: HTTP bearer

Returns the current credit balance for the authenticated organization along with this org's bundle price, per-action extra rates, and lifetime totals. Use this to surface balance in MCP tools, dashboards, or partner integrations.

## Response `200`

Successful Response

- BalanceResponse: Wallet balance + this org's pricing context. Used by GET /api/billing/balance (dashboard) and GET /api/public/v1/balance (Public API/MCP).
  - `balance_cents` integer, required
  - `balance_display` string, required
  - `cap_cents` integer, required
  - `action_prices_cents` object, required
  - `topup_packs_cents` integer[], required
  - `min_topup_cents` integer, required
  - `lifetime_purchased_cents` integer, required
  - `lifetime_granted_cents` integer, required
  - `lifetime_spent_cents` integer, required
  - `reserved_cents` integer
  - `available_cents` integer

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)
