Billing API

Base URL: https://app.kvmfleet.io/v1

Required role: owner

Get current plan

curl https://app.kvmfleet.io/v1/billing/plan \
  -H "Authorization: Bearer $TOKEN"

{
  "plan": "pro",
  "device_limit": 25,
  "devices_used": 8,
  "billing_cycle": "monthly",
  "current_period_end": "2026-05-15T00:00:00Z"
}

Get billing portal URL

Redirects to the Stripe customer portal for managing payment methods, invoices, and plan changes.

curl -X POST https://app.kvmfleet.io/v1/billing/portal \
  -H "Authorization: Bearer $TOKEN"

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

Plans

Plan	Devices	Price
Free	Up to 3	Free
Pro	Up to 25	Paid (monthly/annual)
Enterprise	Unlimited	Contact sales

Webhooks

Billing state is kept in sync via Stripe webhooks. Plan changes, payment failures, and subscription cancellations are processed automatically. No user API calls are needed for these events.