credits

Get Credit Balance

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.

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

Response

Successful Response

balanceinteger required

Credits remaining in current billing period

totalinteger required

Total credits allocated for this billing period

planstring required

Current plan tier (free | pro | legacy builder/studio variants)

warning_levelstring required

Balance warning level

video_usedinteger required

Videos created this month

video_capinteger required

Total videos allowed this month

strategy_sessions_usedinteger required

Strategy sessions used this month

strategy_sessions_includedinteger required

Strategy sessions included in plan

next_reset_atstring date-time required

When credits reset (monthly)

free_creditsinteger

Free bucket (tops up monthly, no rollover)

paid_creditsinteger

Purchased/sub bucket (rolls over)

free_credits_reset_atstring date-time nullable

When the free bucket next tops up

Example response

{
  "balance": 72,
  "next_reset_at": "2026-05-07T08:30:00Z",
  "plan": "builder",
  "strategy_sessions_included": 0,
  "strategy_sessions_used": 0,
  "total": 100,
  "video_cap": 100,
  "video_used": 2,
  "warning_level": "normal"
}

Changes

No recorded changes to this operation across all 1 revision of this API.