Billing

Manage your subscription and billing through the API.

Get Subscription

curl https://api.caged.dev/v1/billing/subscription \
  -H "Authorization: Bearer caged_sk_..."

Response 200 OK

{
  "plan": "pro",
  "status": "active",
  "current_period_end": "2026-07-08T00:00:00Z",
  "usage": {
    "compute_hours": 12.5,
    "llm_cost_usd": 3.42,
    "total_cost_usd": 5.67,
    "sandboxes_created": 8
  }
}

Plans

Plan	Price	Sandboxes	Compute	Support
Free	$0/mo	2 concurrent	10 hrs/mo	Community
Pro	$29/mo	10 concurrent	100 hrs/mo	Email
Team	$99/mo	50 concurrent	500 hrs/mo	Priority
Enterprise	Custom	Unlimited	Custom	Dedicated

Create Checkout Session

Creates a Stripe checkout session for subscription upgrade.

string

required

Plan to subscribe to: pro, team, or enterprise.

curl -X POST https://api.caged.dev/v1/billing/checkout \
  -H "Authorization: Bearer caged_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"plan": "pro"}'

Response 200 OK

{
  "url": "https://checkout.stripe.com/c/pay/..."
}

Create Billing Portal

Creates a Stripe billing portal link for managing payment methods, invoices, and plan changes.

curl -X POST https://api.caged.dev/v1/billing/portal \
  -H "Authorization: Bearer caged_sk_..."

Response 200 OK

{
  "url": "https://billing.stripe.com/p/session/..."
}

Cancel Subscription

Cancels the subscription at the end of the current billing period.

curl -X POST https://api.caged.dev/v1/billing/cancel \
  -H "Authorization: Bearer caged_sk_..."

Response 200 OK

{
  "status": "canceled",
  "effective_at": "2026-07-08T00:00:00Z"
}

​Billing

​Get Subscription

​Plans

​Create Checkout Session

​Create Billing Portal

​Cancel Subscription

Billing

Get Subscription

Plans

Create Checkout Session

Create Billing Portal

Cancel Subscription