<!--
{
  "availability" : [
    "App Store Server API: 1.23.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppStoreServerAPI",
  "identifier" : "/documentation/AppStoreServerAPI/renewalQuantity",
  "metadataVersion" : "0.1.0",
  "role" : "Type",
  "symbol" : {
    "kind" : "Type",
    "modules" : [
      "App Store Server API"
    ],
    "preciseIdentifier" : "data:app_store_server_api:renewalQuantity"
  },
  "title" : "renewalQuantity"
}
-->

# renewalQuantity

The number of seats in the next renewal of an auto-renewable subscription.

```
int32 renewalQuantity
```

## Discussion

The group purchaser manages the number of seats. Seats they add take effect immediately, and a reduction takes effect at the next renewal date. The group purchaser can change the number of seats that renew more than once before the subscription renews, so read `renewalQuantity` from the latest renewal information, for example by calling the [`Get All Subscription Statuses`](/documentation/AppStoreServerAPI/Get-All-Subscription-Statuses) endpoint, rather than tracking the changes yourself.

For the notifications the App Store sends when the number of seats changes, see the `INCREASE_QUANTITY` and `DECREASE_QUANTITY` values of <doc://com.apple.documentation/documentation/AppStoreServerNotifications/subtype>.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)