---
title: "Get coin breakdown for profile (monthly quota left + bonus)"
method: GET
path: "/v1/coins/summary"
tags: ["Coins"]
---

# Get coin breakdown for profile (monthly quota left + bonus)

`GET /v1/coins/summary`

Returns monthly subscription coins remaining vs allowance and bonus (purchased) coins. Uses quota counters when enabled; otherwise derives monthly remainder from the coin ledger since the last SUBSCRIPTION deposit.

## Response `200`

Coin summary retrieved successfully

- CoinSummaryDto
  - `total` number, required — Total spendable coins (monthly + bonus)
  - `monthlyCoins` CoinSummaryBucketDto, required
    - `left` number, required — Coins remaining in this bucket
    - `limit` number — Monthly allowance for the current billing cycle (monthly bucket only)
  - `bonusCoins` CoinSummaryBucketDto, required
    - `left` number, required — Coins remaining in this bucket
    - `limit` number — Monthly allowance for the current billing cycle (monthly bucket only)
  - `quotaResetAt` string, nullable — When the monthly quota resets (ISO 8601), if applicable

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)