---
title: "Read the available balance without approving new work"
method: GET
path: "/v1/capacity/balance"
---

# Read the available balance without approving new work

`GET /v1/capacity/balance`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/capacity/balance`
- Auth: API key in header `Authorization`

## Query parameters

- `project_id` string

## Response `200`

Read the available balance without approving new work

- object
  - `data` CapacityBalanceData, required
    - `currency` 'USD' | 'EUR'
    - `available_cents` integer, required
    - `reserved_cents` integer, required
    - `payment_hold` boolean, required
    - `internal_unlimited` boolean, required
    - `hold_reason` string, nullable
    - `lots` CapacityLotData[], nullable
      - `lot_id` string, required
      - `kind` 'free' | 'free_monthly' | 'purchased' | 'membership' | 'service_refund' | 'bonus', required
      - `available_cents` integer, required
      - `reserved_cents` integer, required
      - `settled_cents` integer, required
      - `expired_cents` integer, required
      - `expires_at` string, date-time, nullable
      - `issued_cents` integer, nullable
      - `issued_at` string, date-time, nullable
    - `free_cycle` CapacityFreeCycleData
      - `first_month` boolean, required
      - `amount_cents` integer, required
      - `period_start` string, date-time, required
      - `period_end` string, date-time, required
    - `trial_ending` CapacityTrialEndingData
      - `event` 'trial_ending'
      - `expires_at` string, date-time, required
      - `remaining_free_cents` integer, required
    - `free_allowance` CapacityFreeAllowanceData, required: Whether this account's free allowance is active; message is shown while it waits.
      - `status` 'unclaimed' | 'review' | 'approved' | 'granted', required
      - `message` string, nullable
    - `membership` CapacityMembershipData
      - `plan_id` string, required
      - `pending_plan_id` string, nullable
      - `billed_by` 'card' | 'app_store' | 'google_play' | 'vercel' | 'digitalocean'
      - `manage_url` string, nullable
      - `next_plan` string, nullable
      - `upgrade_pending` boolean
      - `payment_action_url` string, nullable
      - `change_status` 'pending' | 'running' | 'succeeded' | 'failed' | 'review', nullable
      - `change_error` string, nullable
      - `status` string, required
      - `cancel_at_period_end` boolean, required
      - `paid_period_start` string, date-time, nullable
      - `paid_period_end` string, date-time, nullable
    - `budget_period` string, required
    - `monthly_limit_cents` integer, nullable
    - `period_spent_or_reserved_cents` integer, required

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)