---
title: "Get Credit Balance"
method: GET
path: "/api/v1/credits/balance"
tags: ["credits"]
---

# Get Credit Balance

`GET /api/v1/credits/balance`

## Request

- Base URL: `https://api.slidemaster.tw` (the document declares no server; this is the origin it was published from)
- URL: `https://api.slidemaster.tw/api/v1/credits/balance`
- Auth: none declared

查詢 API Credits 餘額。

回傳欄位：
- balance: 目前餘額
- courses_remaining: 估計可製作幾堂課（floor(balance / 4000)）
- cost_reference: 各操作費率參考

## Headers

- `Authorization` string, nullable
- `X-API-Key` string, nullable

## Response `200`

Successful Response

- CreditBalanceResponse
  - `balance` integer, required
  - `credit_buckets` object, required
  - `courses_remaining` integer, required
  - `lifetime_purchased` integer, required
  - `lifetime_consumed` integer, required
  - `plan_monthly_credits` integer, required
  - `reset_at` string, nullable, required
  - `legacy_reconciliation_status` string, nullable
  - `access_mode` string, nullable
  - `cost_reference` object, required

## Other responses

- `422`: Validation Error

---

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