Subscriptions

Manage recurring billing for customers.

The Subscription object

{
  "id": "sub_abc123",
  "object": "subscription",
  "customer": "cus_xyz789",
  "status": "active",
  "items": [
    { "id": "si_abc", "price": "price_premium_monthly", "quantity": 1 }
  ],
  "current_period_start": 1708300800,
  "current_period_end": 1710979200,
  "created": 1708300800
}

Endpoints

Method	Endpoint	Description
POST	/v1/subscriptions	Create a subscription
GET	/v1/subscriptions/{id}	Retrieve a subscription
PATCH	/v1/subscriptions/{id}	Update a subscription
DELETE	/v1/subscriptions/{id}	Cancel a subscription
GET	/v1/subscriptions	List subscriptions