Stripe - Get Subscriptions

Description

This module allows you to query active and past subscriptions in Stripe. You can get a specific subscription or list multiple with filters.

Configuration

Required Credentials

• Secret Key: Stripe secret key

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Stripe credentials
subscription_id	string	No	Specific ID (sub_xxx)
customer_id	string	No	Filter by customer
price_id	string	No	Filter by price
status	select	No	Filter by status
created_gte	string	No	Created after (Unix timestamp)
limit	number	No	Results limit (default: 10)
starting_after	string	No	Last object ID for pagination

Subscription Statuses

• active: Active
• past_due: Past due
• unpaid: Unpaid
• canceled: Canceled
• incomplete: Incomplete
• incomplete_expired: Incomplete expired
• trialing: In trial period
• paused: Paused

Output

{
  "success": true,
  "subscriptions": [...],
  "count": 10,
  "has_more": true,
  "message": "10 suscripciones obtenidas"
}

Subscription Fields

• id: Subscription ID (sub_xxx)
• status: Current status
• customer: Customer ID
• items: Subscribed products/prices
• current_period_start: Current period start
• current_period_end: Current period end
• cancel_at_period_end: Whether it will cancel at end
• trial_start: Trial start
• trial_end: Trial end

Usage Example

Get by ID

{
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs"
}

Active subscriptions for a customer

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "status": "active"
}

Subscriptions with past due payments

{
  "status": "past_due",
  "limit": 50
}

API Used

• Endpoint: GET /v1/subscriptions
• Documentation: Stripe Subscriptions API

Notes

• A past_due subscription will attempt to charge automatically
• current_period_end indicates when it will renew or cancel
• trialing subscriptions do not charge until the trial ends

Related Nodes

• StripeCreateSubscription - Create new subscriptions
• StripeCancelSubscription - Cancel active subscriptions
• StripeGetCustomers - Get subscription customer data
• StripeGetInvoices - Get invoices generated by subscriptions