Get customer subscriptions

📘

API Refs

Path parameters

NameTypeDescriptionRequired
idstringStripeCustomerID (cus_xxxxx)yes

Response body

Returns an array of subscription objects for the customer, including:

  • StripeSubscriptionID and status
  • Plan details (ID, name, amount, currency, interval)
  • Current billing period start and end dates
  • Whether subscription is set to cancel at period end
  • Subscription creation date

Description

This endpoint retrieves all subscriptions (active, canceled, and past) associated with a specific customer. Use this to view a customer's subscription history, check active subscriptions, or determine their current billing status. The response includes detailed information about each subscription's plan, billing cycle, and current status.