---
title: "Prepare owner-authorized balance or membership checkout without starting work"
method: POST
path: "/v1/capacity/funding"
---

# Prepare owner-authorized balance or membership checkout without starting work

`POST /v1/capacity/funding`

## Request

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

## Request body

- CapacityFundingRequest
  - `kind` 'topup' | 'subscription', required
  - `amount_cents` integer, nullable
  - `plan_id` string, nullable
  - `intended_quote_id` string, nullable
  - `idempotency_key` string, required
  - `currency` 'usd' | 'eur', nullable

## Response `202`

Prepare owner-authorized balance or membership checkout without starting work

- object
  - `data` CapacityFundingData, required
    - `funding_id` string, required
    - `kind` 'topup' | 'subscription', required
    - `state` 'pending' | 'open' | 'paid' | 'expired' | 'failed', required
    - `currency` 'USD' | 'EUR'
    - `amount_cents` integer, required
    - `plan_id` string, nullable
    - `checkout_url` string, nullable
    - `expires_at` string, date-time, required
    - `intended_quote_id` string, nullable
    - `error` string, nullable
    - `execution_authorized` false
    - `next_action` 'review_quote' | 'open_checkout' | 'wait' | 'none', 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)