---
title: "Credit usage summary"
method: GET
path: "/agents/credits/usage/summary"
tags: ["Agents"]
---

# Credit usage summary

`GET /agents/credits/usage/summary`

Returns the current credit allocation and usage broken down by Ask, Build, and MCP tiers.

## Response `200`

- CreditUsageSummary
  - `allocation` CreditAllocationSummary, required
    - `annual_credits` integer
    - `purchased_credits` integer
    - `total_credits` integer, required
    - `period_start` string, date, required
    - `period_end` string, date, required
  - `usage` CreditUsageSummaryData, required
    - `total_used` integer, required
    - `remaining` integer, required
    - `by_tier` CreditUsageByTier, required
      - `ask` integer, required
      - `build` integer, required
      - `mcp` integer, required

---

[API](https://skmtc.net/cubesoftware/apis/cube-api.md) · [All operations](https://skmtc.net/cubesoftware/apis/cube-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cubesoftware/cube-api/revisions/67d9f45bb99b/schema)