Get subscription by ID

📘

API Refs

Path parameters

NameTypeDescriptionRequired
idstringStripeSubscriptionIDyes

Response body

Returns a detailed subscription object with:

  • id: StripeSubscriptionID
  • customerId: StripeCustomerID
  • customerEmail: Customer email
  • status: Subscription status
  • currentPeriodStart: Current billing period start
  • currentPeriodEnd: Current billing period end
  • plan: Plan details (id, stripeId, name, amount, currency, interval)
  • paymentMethod: Payment method details (type, card/bankAccount info)
  • upcomingInvoice: Next invoice information (amount, dueDate, lineItems)

Description

This endpoint retrieves detailed information about a specific subscription. Use this to check subscription status, view billing details, or get information about the associated customer and plan. The response includes comprehensive details about the subscription's current state and billing schedule.