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

# Get Credit Balance

`GET /v1/credits`

## Request

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

Get current credit balance and usage information.

Returns the user's credit balance, plan tier, video cap progress,
and strategy session allocation for their workspace.

## Response `200`

Successful Response

- CreditBalance: Current credit balance and tier information.
  - `balance` integer, required: Credits remaining in current billing period
  - `total` integer, required: Total credits allocated for this billing period
  - `plan` string, required: Current plan tier (free | pro | legacy builder/studio variants)
  - `warning_level` string, required: Balance warning level
  - `video_used` integer, required: Videos created this month
  - `video_cap` integer, required: Total videos allowed this month
  - `strategy_sessions_used` integer, required: Strategy sessions used this month
  - `strategy_sessions_included` integer, required: Strategy sessions included in plan
  - `next_reset_at` string, date-time, required: When credits reset (monthly)
  - `free_credits` integer: Free bucket (tops up monthly, no rollover)
  - `paid_credits` integer: Purchased/sub bucket (rolls over)
  - `free_credits_reset_at` string, date-time, nullable: When the free bucket next tops up

---

[API](https://skmtc.dev/theagentc/apis/the-agent-c-api.md) · [All operations](https://skmtc.dev/theagentc/apis/the-agent-c-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theagentc/apis/the-agent-c-api/revisions/1c9868b44584?raw)