Skip to main content
GET
Get the tenant's active subscription (smart Stripe sync)
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

GET /billing/active Returns the tenant’s active subscription, force-syncing from Stripe when the cache is missing, older than 30 minutes, or the caller is admin/owner (privileged users always get fresh data). On sync failure (e.g. unpaid invoices, subscription-creation failure) returns an error envelope with actionable data instead of throwing. Authorization:
  • Required role: user or higher

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Response

Active subscription retrieved (or sync error with actionable data)

status
string
Example:

"success"

data
object