---
title: "Credit Balance"
method: GET
path: "/billing/credits/balance"
tags: ["billing", "billing-credits"]
---

# Credit Balance

`GET /billing/credits/balance`

## Request

- Base URL: `https://api.threadchain.pro` (the document declares no server; this is the origin it was published from)
- URL: `https://api.threadchain.pro/billing/credits/balance`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Returns the current credit balance, period usage, and recent history
for the authenticated user's organization. Gated by ``wallet.view`` —
org-role defaults already grant this to editors and viewers, so
behavior is unchanged for members without a custom role.

## Query parameters

- `org_id` string, uuid, nullable

## Response `200`

Successful Response

- CreditBalanceResponse
  - `current_balance` integer, required
  - `credits_used_this_period` integer, required
  - `credits_remaining` integer, required
  - `can_download` boolean, required
  - `can_generate` boolean
  - `generation_block_reason` string, nullable
  - `reason` string, nullable
  - `recent_usage` object[], required
  - `free_tech_pack_policy_active` boolean
  - `free_tech_pack_policy_start_at` string, date-time, nullable
  - `free_generation_available` boolean
  - `can_access_designboard` boolean
  - `designboard_block_reason` string, nullable
  - `billing_mode` string, nullable
  - `unit_price_cents` integer, nullable
  - `active_voucher_ends_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/threadchain/apis/threadchain-backend.md) - [All operations](https://skmtc.dev/threadchain/apis/threadchain-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/threadchain/apis/threadchain-backend/revisions/8ee288a7e6bd?raw)