billing

Get the workspace billing summary

The caller's subscription tier/status, seats, remaining credits, and the Stripe publishable key.

get/v1/billing

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/billing
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Response

Successful Response

tier'free' | 'founding' | 'team' | 'business' | 'enterprise' | 'custom' required

The subscription tier (price anchor + included-credit allowance).

FOUNDING is the Pricing-v2 self-serve plan ($45/mo → 20,000 credits/period, full rollover); TEAM/BUSINESS are the legacy per-seat tiers kept for historical rows during the transition. ENTERPRISE stays a manual, off-catalog sale. CUSTOM is a staff-attached negotiated Stripe price — see services.billing.validate_negotiated_price.

statusstring required
seatsinteger required
credits_remaininginteger required

Legacy prepaid credit-pack balance in whole legacy retail credits, floored from the micro-USD ledger. The retail peg is RETAIL_MICRO_USD_PER_CREDIT = 1,000 micro-USD per credit. This balance still funds work. Drawdown cascades into this ledger after credit_balance is exhausted. Legacy retail credits and Patricia credits are different credit units; never add the raw numbers. These are display balances. Admission is decided server-side from the unrounded ledgers; neither field nor their combination determines whether Patricia will run.

credit_balancenumber required

The workspace's balance in Patricia credits, a COGS-denominated credit unit, scaled from whole hundredths for display with at most two decimal places. Drawdown spends this ledger first, then cascades into the legacy credits_remaining ledger. The dashboard shows this balance as credits available. Patricia credits and legacy retail credits are different credit units; never add the raw numbers. These are display balances. Admission is decided server-side from the unrounded ledgers; neither field nor their combination determines whether Patricia will run.

monthly_credit_grantinteger required
cancel_at_period_endboolean required
current_period_endstring nullable required
has_active_subscriptionboolean required
stripe_publishable_keystring nullable required
has_payment_methodboolean
starter_verification_requiredboolean
starter_verification_reason'card_verification' | 'challenge_verification' nullable
holds_live_subscriptionboolean
next_payment_attempt_atstring nullable
payment_recovery_state'retrying' | 'action_needed' | 'failed' | 'ended' nullable

Changes

No recorded changes to this operation across all 1 revision of this API.