---
title: "Get unified billing state"
method: GET
path: "/billing/state"
tags: ["Billing"]
---

# Get unified billing state

`GET /billing/state`

Returns balance, plan, subscription, usage, and convenience flags for the dashboard.

## Response `200`

Billing state

- object
  - `data` object, required
    - `balance` object, required
      - `amount` number, required — Balance in dollars
    - `plan` object, required
      - `slug` string, required — Plan slug: 'free' or 'pro'
      - `name` string, required — Display name
      - `price` number, required — Monthly price in dollars
      - `limits` object, required
        - `concurrentJobs` integer, required
        - `apiRequestsPerMinute` integer, required
        - `maxJobTimeout` integer, required
        - `maxInputFileSize` integer, required
    - `subscription` object, nullable, required
      - `status` string, required
      - `cancelAtPeriodEnd` boolean, required
      - `currentPeriodEnd` number, nullable, required
      - `currentPeriodStart` number, nullable, required
    - `usage` object, required
      - `currentPeriodSpend` number, required — Spend in dollars for the current period
      - `jobCount` integer, required — Jobs in the current period
    - `isPro` boolean, required — True if plan slug is 'pro'
    - `creditBonusRate` number, required — Bonus multiplier on credit purchases
    - `upgradePlan` object, nullable, required — Next plan up for upgrade comparison. Null if on highest plan.
      - `id` string, required — Plan slug
      - `name` string, required — Display name
      - `price` number, required — Monthly price in dollars
      - `limits` object, required
        - `concurrentJobs` integer, required
        - `apiRequestsPerMinute` integer, required
        - `maxJobTimeout` integer, required
        - `maxInputFileSize` integer, required

## Other responses

- `401` — Unauthorized

## Changes

- **2026-08-29** `4d10ec4266ee` — 1 info
  - api operation id `getBillingState` was added
- **2026-07-26** `ad4351c79853` — 2 breaking
  - removed the required property `data/plan/limits/maxBatchSize` from the response with the `200` status
  - removed the required property `data/upgradePlan/limits/maxBatchSize` from the response with the `200` status

[Change history](https://skmtc.dev/rendobar/apis/rendobar-api/changes/billing/state/get.md)

---

[API](https://skmtc.dev/rendobar/apis/rendobar-api.md) · [All operations](https://skmtc.dev/rendobar/apis/rendobar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rendobar/rendobar-api/revisions/4d10ec4266ee/schema)