Skip to content

Get current subscription status, limits, and AI usage

GET
/api/billing/subscription

Auth required. Aggregates subscription, plan limits, item-count limits, and AI usage in one call.

Subscription snapshot

object
ok
required
boolean
data
required
object
subscription
nullable
limits
required
object
isUnlimited
required
boolean
key
additional properties
nullable
canManageBilling
required
boolean
itemLimits
required
object
songs
required
object
key
additional properties
nullable
setlists
required
object
key
additional properties
nullable
aiUsage
nullable
key
additional properties
nullable

Not in any band

object
ok
required
boolean
error
required
string
code
string

Failed to fetch subscription data

object
ok
required
boolean
error
required
string
code
string