---
title: Extend Subscription Renewal Dates for All Active Subscribers
framework: appstoreserverapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreserverapi/extend-subscription-renewal-dates-for-all-active-subscribers
---

# Extend Subscription Renewal Dates for All Active Subscribers

Uses a subscription’s product identifier to extend the renewal date for all of its eligible active subscribers.

## URL

POST https://api.storekit.apple.com/inApps/v1/subscriptions/extend/mass

## Sandbox URL

POST https://api.storekit-sandbox.apple.com/inApps/v1/subscriptions/extend/mass

## Response Codes

200 OK: Request succeeded. If you reuse the requestIdentifier to call the endpoint again, the server responds with 200. 400 Bad Request: The request is invalid and can’t be accepted. 401 Unauthorized: The JSON Web Token (JWT) in the authorization header is invalid. For more information, see Generating JSON Web Tokens for API requests. 403 Forbidden: The request is invalid and can’t be accepted. 404 Not Found: The server didn’t find a subscription-renewal-date extension request for the request identifier and product identifier you provided. 429 : The request exceeded the rate limit. 500 Internal Server Error: The request failed. This may be due to a temporary outage. Check the specific error message for further information.

## Mentioned in

Extending the renewal date for auto-renewable subscriptions App Store Server API changelog Identifying rate limits

## Discussion

Discussion Use this endpoint to compensate your customers for temporary service outages, canceled events, or interruptions to live streamed events by extending the renewal date of their paid, active subscription. This endpoint acts on all active subscriptions for the product identifier you specify, and is limited to the storefronts you optionally specify. To call this endpoint, provide the subscription product identifier that experienced the service interruption, and other information, in the request body, MassExtendRenewalDateRequest. A successful response with an HTTP 200 status code contains the MassExtendRenewalDateResponse object, which includes the same unique requestIdentifier you provide in the request. This endpoint is an asynchronous request. A successful response indicates that the App Store server is processing the request. Status codes other than HTTP 200 indicate that the request failed. note: After the subscription renewal extension goes into effect, there’s no way to reverse it. The extension period doesn’t count toward the one year of paid service when the App Store calculates the developer’s commission rate. After a successful renewal date extension, Apple sends an email to notify the customer of their updated subscription renewal date. For more information about this endpoint, including subscription eligibility, getting status notifications, and retrying extensions that fail, see Extending the renewal date for auto-renewable subscriptions.

## HTTP Body

The request body for extending a subscription renewal date for all of its active subscribers.

## See Also

### Subscription-renewal-date extension

- [Extending the renewal date for auto-renewable subscriptions](appstoreserverapi/extending-the-renewal-date-for-auto-renewable-subscriptions.md)
- [Extend a Subscription Renewal Date](appstoreserverapi/extend-a-subscription-renewal-date.md)
- [Get Status of Subscription Renewal Date Extensions](appstoreserverapi/get-status-of-subscription-renewal-date-extensions.md)
- [ExtendRenewalDateRequest](appstoreserverapi/extendrenewaldaterequest.md)
- [ExtendRenewalDateResponse](appstoreserverapi/extendrenewaldateresponse.md)
- [MassExtendRenewalDateRequest](appstoreserverapi/massextendrenewaldaterequest.md)
- [MassExtendRenewalDateResponse](appstoreserverapi/massextendrenewaldateresponse.md)
- [MassExtendRenewalDateStatusResponse](appstoreserverapi/massextendrenewaldatestatusresponse.md)