Skip to main content
GET
cURL
Pass the exact opaque customerId as a URL-encoded query value. The API key selects the organization and Sandbox or Live environment. Results are ordered newest first and can be paged with limit and the returned nextCursor; hasMore indicates that older rows remain. Each item identifies the plan, status, creation time, and current billing period. Active paid subscriptions include a cancellation state when Stripe can verify it. If that state is unavailable, do not infer that renewal is enabled from a local active status. Use Stop or resume renewal to change a verified paid subscription. Free and pending Checkout subscriptions cannot be managed through that endpoint. Use Get a customer for the current credit balance. A customer’s separately purchased credit packs appear under List customer purchases.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

customerId
string
required
Required string length: 1 - 255
limit
integer
Required range: 1 <= x <= 100
cursor
integer
Required range: x <= 2147483647

Response

Customer subscriptions, newest first

items
object[]
required
hasMore
boolean
required
nextCursor
integer | null
required