---
title: "Get plan and credit balance"
method: GET
path: "/subscription"
tags: ["Subscription"]
---

# Get plan and credit balance

`GET /subscription`

Returns your current plan and credit balance. Call this before generating videos to check you have enough credits.

Paid plans add credits each billing cycle (monthly or yearly). Credits never expire.

**Upgrading:** To upgrade your plan or purchase additional credits, go to https://app.aituber.app/dashboard/billing

## Response `200`

OK

- object
  - `plan` string, required — Your current plan. Determines feature access and per-cycle credit allocation. Values: "Free", "Hobby", "Creator", "Growth", "Pro", "Studio", "Agency", "Business", "Enterprise".
  - `status` 'active' | 'canceled' | 'past_due' | 'trialing' | 'free', required — Subscription status. "active" means your plan is fully operational. "canceled" means it will end at the current period. "past_due" means payment failed (credits still available until resolved). "trialing" means you are in a free trial. "free" means no paid subscription.
  - `credits` integer, required — Credits available to spend right now. Check this before generating a video. If a generation request exceeds your balance, it will return a PAYMENT_REQUIRED error.
  - `monthlyCredits` integer, nullable, required — Credits included with your plan each billing cycle (monthly plans bill monthly; yearly plans grant the full year up front). Null on the Free plan.

## Other responses

- `401` — 401
- `402` — 402
- `403` — 403

---

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