Skip to main content
GET
Get current Stripe subscription (live)
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

GET /billing/stripe/subscription Live read directly from Stripe (not the local mirror) — includes subscription items, prices, and current meter usage. Returns a FREE-plan default shape if no Stripe customer/subscription exists. Authorization:
  • Required role: admin or higher

Code Examples

Authorizations

Authorization
string
header
required

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

Response

Current subscription retrieved

status
string
Example:

"success"

message
string
data
object