> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Subscriptions


## API Docs

- Subscriptions [Preview a subscription](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/post-preview-subscription.md)
- Subscriptions [Preview a subscription by subscription key](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/preview-existing-subscription.md)
- Subscriptions [Create a subscription](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/post-subscription.md)
- Subscriptions [List subscriptions by account key](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/get-subscriptions-by-account.md)
- Subscriptions [Retrieve a subscription by key](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/get-subscriptions-by-key.md)
- Subscriptions [Update a subscription](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/put-subscription.md)
- Subscriptions [Retrieve a subscription by key and version](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/get-subscriptions-by-key-and-version.md)
- Subscriptions [Renew a subscription](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/put-renew-subscription.md)
- Subscriptions [Cancel a subscription](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/put-cancel-subscription.md)
- Subscriptions [Resume a subscription](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/put-resume-subscription.md)
- Subscriptions [Suspend a subscription](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/put-suspend-subscription.md)
- Subscriptions [Delete a subscription by number](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/put-delete-subscription.md)
- Subscriptions [Update subscription custom fields of a subscription version](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/put-update-subscription-custom-fields-of-a-specified-version.md)
- Subscriptions [List subscription metrics by subscription numbers](https://zuora.ferndocs.com/developers/api-reference/zuora-api/orders-and-subscriptions/subscriptions/get-metrics-by-subscription-numbers.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://zuora.ferndocs.com/openapi.json)
- [OpenAPI YAML](https://zuora.ferndocs.com/openapi.yaml)