---
title: "Increase Subscription Item Quantity"
method: POST
path: "/subscription/increasesubscriptionitemquantity"
tags: ["Subscription API"]
---

# Increase Subscription Item Quantity

`POST /subscription/increasesubscriptionitemquantity`

Increases the quantity of a subscription item in a subscription.<br /> For XML examples and schemas, see the [Additional Examples - Increase Subscription Item Quantity](https://dev.cleverbridge.com/page/additional-examples-increase-subscription-item-quantity).

## Headers

- `Accept` 'application/json' | 'application/xml'
- `Content-Type` 'application/json' | 'application/xml'

## Request body

- CleverbridgeBackEndRestApiSubscriptionClassesIncreaseSubscriptionItemQuantityRequest
  - `AlignmentSettings` CleverbridgeBackEndRestApiSubscriptionClassesSubscriptionAlignmentSettings — Define the behavior when adding or updating a subscription item. For more information, see [Alignment Settings](https://dev.cleverbridge.com/docs/subscription-api-get-started#alignment-settings).
    - `AlignToCurrentInterval` boolean, required — Set to <code>true</code> if you want the customer to be charged immediately for the updated item (for example, a quantity increase). Otherwise, the customer will be charged at the next renewal.
    - `ExtendInterval` boolean — Set to <code>true</code> if you want to charge a full interval for the updated item (for example, a quantity increase). Otherwise, the customer will be charged a pro-rated amount for the updated item that corresponds to the time between the update and the next renewal. Important: <code>AlignToCurrentInterval</code> must be set to <code>true</code> if <code>ExtendInterval</code> is set to <code>true</code>.
    - `GetCustomerPricePreviewOnly` boolean, required — Set to <code>true</code> if you only want to obtain preview data in the response. You can use this data to display a price preview to a customer or for testing purposes.
  - `GenerateMail` boolean — Set to <code>false</code> if you want to suppress the automatically generated email that informs the customer about the subscription update. Important: If set to <code>false</code>, you must send the email yourself. For more information, see [Best Practices: Obtaining Customer Consent](https://docs.cleverbridge.com/public/all/using-the-platform/best-practices-obtain-customer-consent.htm?utm_source=developer-docs&amp;utm_medium=api-reference).
  - `Quantity` integer, required — Number of additional items. For example <code>2</code>, if you want to increase the quantity from <code>1</code> to <code>3</code>.
  - `RunningNumber` integer, required — Running number of the item in the subscription.
  - `SubscriptionId` string, required — Unique ID of the subscription, with or without an initial 'S'.

## Response `200`

OK

- CleverbridgeBackEndRestApiSubscriptionClassesIncreaseSubscriptionItemQuantityResponse
  - `AlignmentCustomerGrossPrice` number, double — Total gross price for alignment interval. Only for <code>CustomerPricePreview-Mode</code>.
  - `AlignmentCustomerNetPrice` number, double — Total net price for alignment interval. Only for <code>CustomerPricePreview-Mode</code>.
  - `AlignmentCustomerVatPrice` number, double — Total VAT amount for alignment interval. Only for <code>CustomerPricePreview-Mode</code>.
  - `NextBillingCustomerGrossPrice` number, double — Total gross price for next billing interval. Only for <code>CustomerPricePreview-Mode</code>.
  - `NextBillingCustomerNetPrice` number, double — Total net price next billing interval. Only for <code>CustomerPricePreview-Mode</code>.
  - `NextBillingCustomerVatPrice` number, double — Total VAT amount for next billing interval. Only for <code>CustomerPricePreview-Mode</code>.
  - `NextRenewalCustomerGrossPrice` number, double — Total gross price for next subscription interval. Only for <code>CustomerPricePreview-Mode</code>.
  - `NextRenewalCustomerNetPrice` number, double — Total net price next subscription interval. Only for <code>CustomerPricePreview-Mode</code>.
  - `NextRenewalCustomerVatPrice` number, double — Total VAT amount for next subscription interval. Only for <code>CustomerPricePreview-Mode</code>.
  - `PriceCurrencyId` string — Currency code in capital letters, see [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
  - `ResultMessage` string — Optional result or error message.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/cleverbridge/apis/backend-rest-apis.md) · [All operations](https://skmtc.net/cleverbridge/apis/backend-rest-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleverbridge/backend-rest-apis/versions/b7007b62f4c0/schema)