Skip to content

Get billing summary

GET
/billing/summary
curl --request GET \
--url https://example.com/api/billing/summary \
--header 'Authorization: Bearer <token>'

Returns the current plan, subscription status, and Stripe identifiers.

Billing summary

Media type application/json
object
plan
required
string
Example
free
planLabel
required
string
Example
Free
status

Stripe subscription status

string | null
Example
active
currentPeriodEnd
string | null format: date-time
cancelAtPeriodEnd
required
boolean
billingAccountId
string | null format: uuid
stripeCustomerId
string | null

Not authenticated

Media type application/json
object
error
required

Human-readable error message

string
code

Stable machine-readable error code for client branching

string
fieldErrors

First validation message per field path

object
key
additional properties
string
issues

Structured validation issues (Zod)

Array<object>
object
path
required
string
message
required
string
retryAfter

Seconds until rate limit resets (429 responses)

number
reconnect

True if re-linking GitHub may fix the issue

boolean