Skip to main content
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
    }
  }
}
Plan values: free | developer | pro | enterprise Status values: active | past_due | canceled | trialing

​
Subscribe / upgrade plan

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"
}
FieldTypeRequiredDescription
planstring✓developer, pro, or enterprise
Response 204: No content.

​
Plan comparison

FeatureFreeDeveloperProEnterprise
Servers21050Unlimited
Requests / month10,000100,0001,000,000Unlimited
Regionsord onlyAllAllAll
Auto-stopRequiredOptionalOptionalOptional
Deployments kept3101010
SupportCommunityEmailPriorityPriority
Price$0$29/mo$99/mo$199/mo
See Billing Tiers for full details.