---
title: "Fetch the authenticated user's credit balance"
method: GET
path: "/balance"
tags: ["Balance"]
---

# Fetch the authenticated user's credit balance

`GET /balance`

Returns the current credit balance for the authenticated account. This endpoint does not consume credits.

## Response `200`

Balance found

- BalanceResponse
  - `balance` CreditBalance, required
    - `credits` integer, required — Total spendable credits across subscription and bundle pools.
    - `subscriptionCredits` integer, required — Credits from the active subscription grant.
    - `bundleCredits` integer, required — Purchased or granted credits that do not expire through subscription renewal.
    - `monthlyCreditLimit` integer, nullable, required — Included monthly subscription credits, or null when no active subscription limit is available.
    - `monthlyCreditsRenewAt` string, date-time, nullable, required — Subscription credit renewal timestamp, or null when renewal details are unavailable.

## Other responses

- `401` — Missing or invalid API key
- `404` — Resource not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/mediacaption/apis/media-caption-public-api.md) · [All operations](https://skmtc.net/mediacaption/apis/media-caption-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mediacaption/media-caption-public-api/versions/e8de0cf41dcd/schema)