Skip to content
Trile Docs

List subscriptions for the merchant business. Cursor pagination. Optional ?status= filter (trialing|active|past_due|unpaid|cancelled).

GET
/v1/subscriptions

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
status
string
limit
string
cursor
string

Header Parameters

Section titled “Header Parameters ”
Idempotency-Key
string

Required on every mutating /v1/* endpoint (Phase 1 fixture relaxes to optional)

Responses

Section titled “ Responses ”

200

Section titled “200 ”
object
success
required
boolean
data
required
object
items
required
Array<object>
object
id
required
string
businessId
required
string
userId
required
string
priceId
required
string
customerId
required
string
status
required
string
Allowed values: trialing active past_due unpaid cancelled
cancelAtPeriodEnd
required
boolean
trialEndAt
required
string format: date-time
nullable
currentPeriodStart
required
string format: date-time
currentPeriodEnd
required
string format: date-time
retryCount
required
integer
>= -9007199254740991 <= 9007199254740991
nextRetryAt
required
string format: date-time
nullable
lastBilledAt
required
string format: date-time
nullable
billingRunId
required
string
nullable
metadata
required
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
nextCursor
required
string
nullable
meta
required
object
requestId
required
string