# Subscriptions

Subscriptions allow you to charge a customer on a recurring basis, such as a monthly charge or a charge based on usage and must be associated with an Account object. Subscriptions can also include one-time charges, such as service activation fees.

## Retrieve a subscription

 - [GET /subscriptions/{subscription_id}](https://developer.zuora.com/other-api/quickstart-api/subscriptions/getsubscriptionbykey.md): Retrieves the subscription with the given subscription key (number or ID).

## Update a subscription

 - [PATCH /subscriptions/{subscription_id}](https://developer.zuora.com/other-api/quickstart-api/subscriptions/patchsubscription.md): Updates the specified subscription by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

## List subscriptions

 - [GET /subscriptions](https://developer.zuora.com/other-api/quickstart-api/subscriptions/getsubscriptions.md): Returns a dictionary with a data property that contains an array of subscriptions, starting after the cursor, if used. Each entry in the array is a separate subscription object. If no more subscriptions are available, the resulting array will be empty. This request should never return an error.

## Create a subscription

 - [POST /subscriptions](https://developer.zuora.com/other-api/quickstart-api/subscriptions/createsubscription.md): Creates a new subscription.

## Pause a subscription

 - [POST /subscriptions/{subscription_id}/pause](https://developer.zuora.com/other-api/quickstart-api/subscriptions/pausesubscription.md): Pauses a subscription.

## Resume a subscription

 - [POST /subscriptions/{subscription_id}/resume](https://developer.zuora.com/other-api/quickstart-api/subscriptions/resumesubscription.md): Resumes a subscription.

## Cancel a subscription

 - [POST /subscriptions/{subscription_id}/cancel](https://developer.zuora.com/other-api/quickstart-api/subscriptions/cancelsubscription.md): Cancels a subscription.

## Activate a subscription

 - [POST /subscriptions/{subscription_id}/activate](https://developer.zuora.com/other-api/quickstart-api/subscriptions/activatesubscription.md): A subscription must be active before you can bill your subscribers. Activating a subscription requires entering at least one of the following dates: contract_effective, service_activation, and customer_acceptance. See Billing Trigger Dates for more information.

## Preview a subscription

 - [POST /subscriptions/preview](https://developer.zuora.com/other-api/quickstart-api/subscriptions/previewsubscription.md): You can preview the billing document metrics or the order delta metrics across a specified time frame.

## Preview an existing subscription

 - [POST /subscriptions/{subscription_id}/preview](https://developer.zuora.com/other-api/quickstart-api/subscriptions/previewexistingsubscription.md): You can preview the billing document metrics or the order delta metrics across a specified time frame.

## List all versions of a subscription

 - [GET /subscriptions/{subscription_id}/versions](https://developer.zuora.com/other-api/quickstart-api/subscriptions/getsubscriptionbyversion.md): Lists all versions of the specified subscription.

## Uncancel a subscription (deprecated)

 - [POST /subscriptions/{subscription_id}/keep](https://developer.zuora.com/other-api/quickstart-api/subscriptions/uncancelsubscription.md): Uncancel a cancelled subscription.