Skip to main content
GET
Get a subscription

Authorizations

Authorization
string
header
required

Your account's secret key: Authorization: Bearer sk_test_… or sk_live_…. Server-side only.

Path Parameters

subscriptionID
string<uuid>
required

Subscription ID.

Response

Success.

id
string<uuid>
customerId
string<uuid>

Enrollment ID.

productVersionId
string<uuid>

The product version subscribed to. It sets the price billed, even if the product changes later.

status
enum<string>
Available options:
trialing,
active,
past_due,
paused,
canceled
billingCycle
enum<string>
Available options:
weekly,
monthly,
annual
collectionMethod
enum<string>

charge_automatically charges on its own; send_invoice sends the invoice for the customer to pay.

Available options:
charge_automatically,
send_invoice
billingMode
enum<string>

advance bills at the start of the period; arrears, at the end.

Available options:
arrears,
advance
anchor
string<date-time>

Reference date the billing periods are counted from.

nextBillingDate
string<date-time> | null

Next billing date.

startedAt
string<date-time>
canceledAt
string<date-time> | null
items
object[]

What the subscription bills or grants.