---
title: renewalQuantity
framework: App Store Server API
role: symbol
role_heading: Type
platforms: [app store server api 1.23+]
path: appstoreserverapi/renewalquantity
---

# renewalQuantity

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

## Declaration

```data
int32 renewalQuantity
```

## Mentioned in

App Store Server API changelog

## Discussion

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 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 subtype.

## See Also

### Multiseat purchases

- [TransactionMultiSeatInfo](appstoreserverapi/transactionmultiseatinfo.md)
- [invitationManagement](appstoreserverapi/invitationmanagement.md)
- [additionalTransactionReason](appstoreserverapi/additionaltransactionreason.md)
- [MultiSeatPriceTier](appstoreserverapi/multiseatpricetier.md)
- [tierPrice](appstoreserverapi/tierprice.md)
- [tierQuantity](appstoreserverapi/tierquantity.md)
- [revokedSeatQuantity](appstoreserverapi/revokedseatquantity.md)
- [RenewalMultiSeatInfo](appstoreserverapi/renewalmultiseatinfo.md)