Billing

Required scope: billing:read

Get billing status

GET /v1/billing

Returns the current subscription and usage summary. Response 200:

{
  "data": {
    "plan": "developer",
    "status": "active",
    "currentPeriodStart": "2026-03-01T00:00:00Z",
    "currentPeriodEnd": "2026-04-01T00:00:00Z",
    "usage": {
      "requestCount": 42000,
      "computeSeconds": 18300,
      "bandwidthBytes": 5242880
    },
    "limits": {
      "requestsPerMonth": null,
      "computeSecondsPerMonth": null,
      "maxServers": 10
    }
  }
}

POST /v1/billing/subscribe

Initiates a Stripe checkout session to subscribe or upgrade. Use this to go from the free plan to a paid plan. Request body:

{
  "plan": "developer"
}

Response 201:

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

Redirect the user to url to complete payment.

Cancel subscription

DELETE /v1/billing/subscribe

Cancels the current paid subscription at the end of the current billing period (cancel_at_period_end = true in Stripe). The subscription remains active until the period ends. Response 204: No content.

Change plan

PATCH /v1/billing/plan

Immediately changes the active paid subscription to a different paid plan (e.g. Developer → Pro). This performs an inline Stripe subscription update without a new checkout session. To downgrade to the free plan, use DELETE /v1/billing/subscribe (cancel) instead. To upgrade from the free plan, use POST /v1/billing/subscribe (checkout) instead. Request body:

{
  "plan": "pro"
}

Field	Type	Required	Description
`plan`	string	✓	`developer`, `pro`, or `enterprise`

Response 204: No content.

Plan comparison

Feature	Free	Developer	Pro	Enterprise
Servers	2	10	50	Unlimited
Requests / month	10,000	100,000	1,000,000	Unlimited
Regions	`ord` only	All	All	All
Auto-stop	Required	Optional	Optional	Optional
Deployments kept	3	10	10	10
Support	Community	Email	Priority	Priority
Price	$0	$29/mo	$99/mo	$199/mo

See Billing Tiers for full details.

API Reference

Ready

Get billing status

Cancel subscription

Change plan

Plan comparison

​Get billing status

​Subscribe / upgrade plan

​Cancel subscription

​Change plan

​Plan comparison

Get billing status

Subscribe / upgrade plan

Cancel subscription

Change plan

Plan comparison