# Pricing

## Plans

### Free

- Ephemeral sessions only (no persistent workspaces)
- 1 concurrent session
- Sessions time out after 1 hour

### Usage-based

- $0.05 per session-hour (metered per second)
- Prepaid wallet balance required to create sessions
- Persistent workspaces enabled

### Subscription

- Plan-specific limits for concurrency, workspaces, and session duration
- Usage metering for observability
- Persistent workspaces enabled

## Billing summary

Check your current billing status:

```bash
curl -sS "$CHASER_API_URL/v1/billing/summary" \
  -H "Authorization: Bearer $CHASER_API_KEY" | jq
```

Returns:
- Pricing model and plan
- Plan limits (concurrency, workspaces, session duration)
- Wallet balance (for usage-based accounts)
- Workspace storage usage and cap
- Usage windows (last 24h, last 30d)

Billing is scoped to the active account selected by `X-Chaser-Account`.

## Adding credits

Usage-based accounts maintain a prepaid wallet balance. Add credits through Stripe checkout:

```bash
curl -sS "$CHASER_API_URL/v1/billing/checkout" \
  -H "Authorization: Bearer $CHASER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "topup", "amount_usd": 10}' | jq
```

Minimum top-up amount is $10.

## Subscribing to a plan

```bash
curl -sS "$CHASER_API_URL/v1/billing/checkout" \
  -H "Authorization: Bearer $CHASER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "subscription", "plan_code": "pro"}' | jq
```

## Workspace storage

- Each workspace has a 10 GB disk baseline
- Per-account total storage is capped at 25 GB
- Storage usage is measured as actual on-disk bytes
- Storage limits are enforced when creating workspaces and attaching persistent sessions
- Current usage is reported in `GET /v1/billing/summary`

## Proxy defaults

- **Free plan:** browser sessions use a free proxy tier
- **Paid plans:** browser sessions default to the US proxy pool
- Explicit `proxy` selector on session creation overrides the default