credits

Get Usage Summary

Get aggregate credit usage for the current billing period.

Shows total spent, earned, and breakdown by reason. Useful for understanding where credits are being consumed.

get/v1/credits/usage

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/usage
  • Auth: HTTP bearer

Response

Successful Response

total_spentinteger required

Total credits spent (absolute value)

total_earnedinteger required

Total credits earned (e.g., from resets)

breakdown_by_reasonobject required

Credit changes grouped by reason

period_startstring date-time required

Start of billing period

period_endstring date-time required

End of billing period (next reset)

Example response

{
  "breakdown_by_reason": {
    "mode_1_text": -1,
    "mode_1_video": -18,
    "monthly_reset": 200
  },
  "period_end": "2026-04-07T08:30:00Z",
  "period_start": "2026-03-07T08:30:00Z",
  "total_earned": 200,
  "total_spent": 50
}

Changes

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