> For the complete documentation index, see [llms.txt](https://docs.digitalriver.com/commerce-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/immediately-apply-a-midterm-subscription-change/reducing-the-subscription-renewal-quantity.md).

# Reducing the subscription renewal quantity

Sometimes, businesses need to adjust the quantity of a subscription renewal to meet changing customer requirements or business strategies. The Reduce resource offers a simple method to reduce the renewal quantity of a subscription via a Reduce resource call. This feature ensures that your business remains flexible and responsive to customers' needs by adjusting subscription quantities. Whether due to a change in customer preference or a need for cost optimization, decreasing a subscription's renewal quantity can be a strategic move that saves costs and enhances customer satisfaction. This guide aims to help you reduce the quantity of a subscription product using the Digital River API.

There are several reasons why a customer might want to reduce their subscription quantity:

* **Change in needs**: A customer's requirement for a product or service might decrease, making it unnecessary to continue with the original quantity.
* **Budget adjustments**: Customers must reduce the costs associated with their subscriptions to accommodate budgetary constraints or financial planning.
* **Utilization analysis**: After analyzing the usage of the subscribed product or service, a customer may find that they need to fully use the original quantity and, therefore, decide to reduce it.
* **Business strategy shifts**: A shift in business strategy or focus can lead to changes in the resources allocated, necessitating a reduction in subscription quantities.
* **Seasonal or cyclical demand**: Businesses with seasonal or cyclical demand might want to adjust subscription quantities to optimize operations and costs.

Use the [`POST /v1/subscriptions/{subscriptionId}/reduce`](https://docs.digitalriver.com/commerce-api-references/admin-apis/subscription-mangement/apply-an-immediate-midterm-change#v1-subscriptions-subid-reduce) request to reduce the subscription renewal quantity. This method allows you to decrease the quantity of a subscription product. You must provide the `{subscriptionId}` of the subscription product you want to reduce and the new `quantity`. To get the subscription ID, see [Getting all subscriptions for a shopper.](/commerce-api/shopper-apis/subscriptions/retrieve-the-subscription/getting-a-shoppers-subscription.md)

Imagine a customer has two subscriptions and decides to reduce the subscription product to one. The following example illustrates how to decrease a subscription product to a quantity of 1.

{% tabs %}
{% tab title="cURL" %}

```javascript
curl --location --request POST 'https://api.digitalriver.com/v1/subscriptions/{subscriptionId}/reduce' \
--header 'authorization: bearer {Your_Authorization_Token}\
...
--data-raw '{
  "product" : {
    "id" : "5410723500"
  },
  "quantity" : 1
}'
```

{% endtab %}

{% tab title="202 OK response" %}

```json
curl --location --request POST 'https://api.digitalriver.com/v1/subscriptions/{subscriptionId}>/reduce' \
--header 'authorization: bearer ***\
...
--data-raw '{
  "product" : {
    "id" : "5410723500"
  },
  "quantity" : 1
}'
```

{% endtab %}
{% endtabs %}

Replace `{Your_Authorization_Token}` with your actual authorization token, `[Product_ID]` with the product ID, you want to reduce, and `{subscriptionId}` with the actual ID of the subscription you're modifying.

This command modifies the subscription by reducing the included product to the specified quantity. For more detailed information and additional parameters, see the [query parameters](https://docs.digitalriver.com/commerce-api-references/admin-apis/subscription-mangement/apply-an-immediate-midterm-change#v1-subscriptions-subid-reduce).

{% hint style="info" %}
The Reduce resource will immediately update the “current” subscription quantity. However, it will not trigger an automatic refund for the shopper.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/immediately-apply-a-midterm-subscription-change/reducing-the-subscription-renewal-quantity.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.