---
title: "Get billing status"
method: GET
path: "/api/billing/status"
tags: ["billing"]
---

# Get billing status

`GET /api/billing/status`

[cloud-only] Returns the authenticated user's current billing and subscription status.

## Response `200`

Billing status

- BillingStatusResponse — [cloud-only] Current billing and subscription status for a workspace.
  - `is_active` boolean, required — Whether the workspace has an active subscription
  - `subscription_status` 'active' | 'ended' | 'canceled' — Subscription activity status (scheduled subscriptions are not returned)
  - `subscription_tier` 'FREE' | 'STANDARD' | 'CREATOR' | 'PRO' | 'FOUNDERS_EDITION' — [cloud-only] Subscription tier (uppercase to match comfy-api)
  - `subscription_duration` 'MONTHLY' | 'ANNUAL' — [cloud-only] Billing period (uppercase to match comfy-api)
  - `plan_slug` string — Plan identifier (e.g., standard-monthly, team-pro-annual)
  - `billing_status` BillingStatus — [cloud-only] Overall billing and subscription status.
    - `subscription` BillingSubscription — [cloud-only] Active subscription details.
      - `id` string, required
      - `status` 'active' | 'cancelled' | 'past_due' | 'trialing', required
      - `plan_id` string, required
      - `plan_name` string
      - `current_period_start` string, date-time
      - `current_period_end` string, date-time
      - `cancel_at_period_end` boolean
    - `balance` BillingBalance — [cloud-only] Current credit balance and usage summary.
      - `credits_remaining` integer, required — Available credits
      - `credits_used` integer — Credits used in current billing period
      - `credits_total` integer — Total credits allocated in current period
    - `has_payment_method` boolean
  - `has_funds` boolean, required — Whether the workspace has available credits
  - `cancel_at` string, date-time — When the subscription will become inactive (if canceled)
  - `renewal_date` string, date-time — When the current billing period ends and the next one begins

## Other responses

- `401` — Unauthorized
- `404` — Workspace not found
- `500` — Internal server error

## Changes

- **2026-05-23** `8eec9009e003` — 5 warning
  - added the new `awaiting_payment_method` enum value to the `billing_status` response property for the response status `200`
  - added the new `inactive` enum value to the `billing_status` response property for the response status `200`
  - added the new `paid` enum value to the `billing_status` response property for the response status `200`
  - added the new `payment_failed` enum value to the `billing_status` response property for the response status `200`
  - …1 more
- **2026-05-22** `c4db9e1283df` — 3 warning, 9 info
  - removed the optional property `balance` from the response with the `200` status
  - removed the optional property `has_payment_method` from the response with the `200` status
  - removed the optional property `subscription` from the response with the `200` status
  - added the optional property `billing_status` to the response with the `200` status
  - …8 more
- **2026-05-22** `09a5075587c8` — 2 info
  - added the non-success response with the status `404`
  - added the non-success response with the status `500`
- **2026-05-08** `c9640fded659` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/comfy-org/apis/comfyui-api/changes/api/billing/status/get.md)

---

[API](https://skmtc.dev/comfy-org/apis/comfyui-api.md) · [All operations](https://skmtc.dev/comfy-org/apis/comfyui-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/comfy-org/comfyui-api/revisions/8eec9009e003/schema)