<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/win-back-offers",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Win-back offers"
}
-->

# Win-back offers

Create and manage win-back offers for your auto-renewable subscriptions.

## Discussion

Win-back offers are offers you create for your apps to re-acquire churned subscribers of an auto-renewable subscription. To learn more, see [Creating and configuring win-back offers](/documentation/AppStoreConnectAPI/Creating-and-configuring-win-back-offers).

## Topics

### Managing win-back offers

### Endpoints

[Creating and configuring win-back offers](/documentation/AppStoreConnectAPI/Creating-and-configuring-win-back-offers)

Configure win-back offers for your auto-renewable subscriptions with the App Store Connect API.

[`List Win-Back Offers`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-winBackOffers)

The data structure that represents a get-v1-subscriptions-{id}-win back offers resource.

[`List win-back offer IDs for an auto-renewable subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-winBackOffers)

[`Read Win-Back Offer Information`](/documentation/AppStoreConnectAPI/GET-v1-winBackOffers-_id_)

The data structure that represents a get-v1-win back offers-{id} resource.

[`List Win-Back Offer Prices`](/documentation/AppStoreConnectAPI/GET-v1-winBackOffers-_id_-prices)

The data structure that represents a get-v1-win back offers-{id}-prices resource.

[`List price IDs for a win-back offer`](/documentation/AppStoreConnectAPI/GET-v1-winBackOffers-_id_-relationships-prices)

[`Create a Win-Back Offer`](/documentation/AppStoreConnectAPI/POST-v1-winBackOffers)

Create a win-back offer for a specific subscription.

[`Modify a Win-Back Offer`](/documentation/AppStoreConnectAPI/PATCH-v1-winBackOffers-_id_)

The data structure that represents a patch-v1-win back offers-{id} resource.

[`Delete a Win-Back Offer`](/documentation/AppStoreConnectAPI/DELETE-v1-winBackOffers-_id_)

The data structure that represents a delete-v1-win back offers-{id} resource.

### Objects

[`object WinBackOffer`](/documentation/AppStoreConnectAPI/WinBackOffer)

A promotional offer targeting lapsed subscribers, providing a discount or free trial to encourage them to resubscribe.

[`object WinBackOfferCreateRequest`](/documentation/AppStoreConnectAPI/WinBackOfferCreateRequest)

The request body you use to create a winback offer.

[`object WinBackOfferPrice`](/documentation/AppStoreConnectAPI/WinBackOfferPrice)

The territory-specific customer price and duration for a win-back subscription offer.

[`object WinBackOfferPriceInlineCreate`](/documentation/AppStoreConnectAPI/WinBackOfferPriceInlineCreate)

An inline object for specifying territory-specific pricing when creating or updating a win-back offer.

[`object WinBackOfferPricesResponse`](/documentation/AppStoreConnectAPI/WinBackOfferPricesResponse)

The response body for endpoints that list prices for a win-back offer.

[`object WinBackOfferResponse`](/documentation/AppStoreConnectAPI/WinBackOfferResponse)

The response body for endpoints that create, read, or modify a single win-back offer for a subscription.

[`object WinBackOfferUpdateRequest`](/documentation/AppStoreConnectAPI/WinBackOfferUpdateRequest)

The request body you use to update a win-back offer.

[`object WinBackOffersResponse`](/documentation/AppStoreConnectAPI/WinBackOffersResponse)

The response body for endpoints that list win-back offers for a subscription.

[`object IntegerRange`](/documentation/AppStoreConnectAPI/IntegerRange)

Describe the upper and lower integer bound of the attribute.

[`object WinBackOfferPricesLinkagesResponse`](/documentation/AppStoreConnectAPI/WinBackOfferPricesLinkagesResponse)

[`object SubscriptionWinBackOffersLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionWinBackOffersLinkagesResponse)


---

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)