Get the current subscription and plan entitlements.
GET /api/v1/billing/subscription
Requires billing.read permission. Returns the organization’s active subscription and its resource limits.
Show SubscriptionSummary properties
stripe.free, pro, or enterprise.active, trialing, past_due, canceled, or suspended.null if no payment method has been set up.null for free plans.| Status | When |
|---|---|
401 | Missing or invalid Bearer token |
403 | Caller lacks billing.read permission |
curl http://localhost:8080/api/v1/billing/subscription \
-H "Authorization: Bearer <token>"
{
"subscription": {
"provider": "stripe",
"plan": "pro",
"status": "active",
"seats": 10,
"limits": {
"environments": 10,
"flags": 500,
"seats": 10,
"monthly_evaluations": 10000000
},
"provider_customer_id": "cus_abc123",
"provider_subscription_id": "sub_abc123",
"current_period_start": "2026-03-01T00:00:00Z",
"current_period_end": "2026-04-01T00:00:00Z",
"cancel_at_period_end": false
}
}