---
title: "Get credit usage summary"
method: GET
path: "/api/v1/billing/usage"
tags: ["billing"]
---

# Get credit usage summary

`GET /api/v1/billing/usage`

## Request

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

Returns cumulative credit usage for the authenticated user, plus current workspace usage and project/Brain-level usage.

## Response `200`

Successful Response

- CreditUsageResponse
  - `user_id` string, required
  - `workspace_id` string, required
  - `balance` integer, required
  - `granted` integer, required
  - `used` integer, required
  - `workspace_balance` integer, required
  - `workspace_granted` integer, required
  - `workspace_used` integer, required
  - `cost_usd_micros` integer, required
  - `workspace_cost_usd_micros` integer, required
  - `categories` CreditCategoryUsageRead[], required
    - `reason` string, required
    - `label` string, required
    - `granted` integer, required
    - `used` integer, required
    - `balance` integer, required
    - `cost_usd_micros` integer, required
  - `projects` CreditProjectUsageRead[], required
    - `project_id` string, required
    - `project_type` 'workspace' | 'brain', required
    - `name` string, required
    - `workspace_id` string, required
    - `granted` integer, required
    - `used` integer, required
    - `balance` integer, required
    - `cost_usd_micros` integer, required

## Other responses

- `401`: Missing or invalid Supabase bearer token.

---

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