# Subscription Schedule

## Endpoints

### Create a schedule

- [POST /v1/subscription_schedules](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2025-06-30.preview)

### Update a schedule

- [POST /v1/subscription_schedules/:id](https://docs.stripe.com/api/subscription_schedules/update.md?api-version=2025-06-30.preview)

### Retrieve a schedule

- [GET /v1/subscription_schedules/:id](https://docs.stripe.com/api/subscription_schedules/retrieve.md?api-version=2025-06-30.preview)

### List all schedules

- [GET /v1/subscription_schedules](https://docs.stripe.com/api/subscription_schedules/list.md?api-version=2025-06-30.preview)

### Cancel a schedule

- [POST /v1/subscription_schedules/:id/cancel](https://docs.stripe.com/api/subscription_schedules/cancel.md?api-version=2025-06-30.preview)

### Release a schedule

- [POST /v1/subscription_schedules/:id/release](https://docs.stripe.com/api/subscription_schedules/release.md?api-version=2025-06-30.preview)

A subscription schedule allows you to create and manage the lifecycle of a subscription by predefining expected changes.

Related guide: [Subscription schedules](https://docs.stripe.com/docs/billing/subscriptions/subscription-schedules.md?api-version=2025-06-30.preview)