<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-store-connect-api-3-6-release-notes",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "App Store Connect API 3.6 release notes"
}
-->

# App Store Connect API 3.6 release notes

Update your server-side code to use new features, and test your code against API changes.

## Discussion

App Store Connect API version 3.6 provides resources that enable you to automate actions you take in App Store Connect.

### New Features

- Win-back offers can now be configured using [Win-back offers](/documentation/AppStoreConnectAPI/win-back-offers). These are offers to bring back churned or expired customers to a subscription.  To learn more, see [Creating and configuring win-back offers](/documentation/AppStoreConnectAPI/Creating-and-configuring-win-back-offers).
- Developers can now use [Subscription images](/documentation/AppStoreConnectAPI/subscription-images) and [In-App Purchase images](/documentation/AppStoreConnectAPI/in-app-purchase-images) endpoints to manage images for promoting subscriptions and In-App Purchases.
- Age ratings for Australia and Korea can be read using [`Read app info information`](/documentation/AppStoreConnectAPI/GET-v1-appInfos-_id_).
- There are two new attributes available for age rating declarations. Use [`Modify an age rating declaration`](/documentation/AppStoreConnectAPI/PATCH-v1-ageRatingDeclarations-_id_) to set the attributes `lootbox` and `koreaAgeRatingOverride`, to learn more, see [`AgeRatingDeclarationUpdateRequest.Data.Attributes`](/documentation/AppStoreConnectAPI/AgeRatingDeclarationUpdateRequest/Data-data.dictionary/Attributes-data.dictionary).
- The `INSTALLS` report type now has a detailed and summary monthly option for [`Download sales and trends reports`](/documentation/AppStoreConnectAPI/GET-v1-salesReports).
- The [`TerritoryAvailability.Attributes`](/documentation/AppStoreConnectAPI/TerritoryAvailability/Attributes-data.dictionary) resource now has two additional `contentStatuses` possible values, `ICP_NUMBER_MISSING` and `ICP_NUMBER_INVALID`. To learn more, see the “Availability in China mainland” section in [App Store Connect Help](https://developer.apple.com/help/app-store-connect/reference/app-information).
- Developers can now upload screenshots for Apple Watch Series 10, to learn more about possible values, see [`ScreenshotDisplayType`](/documentation/AppStoreConnectAPI/ScreenshotDisplayType).
- Developers can now add an app encryption declaration for a given app using [`Create an app encryption declaration`](/documentation/AppStoreConnectAPI/POST-v1-appEncryptionDeclarations).

### Improvements

- The OpenAPI specification ([downloadable here](https://developer.apple.com/sample-code/app-store-connect/app-store-connect-openapi-specification.zip)) values has improved `operationId` names and the Apple managed [Swift OpenAPI generator](https://github.com/apple/swift-openapi-generator) now produces more readable names for the App Store Connect API operations.
- [`SubscriptionStatusUrlVersion`](/documentation/AppStoreConnectAPI/SubscriptionStatusUrlVersion) normalized to all caps values such as `V1` and `V2`.
- The [`List apps`](/documentation/AppStoreConnectAPI/GET-v1-apps) resources now has more optional filters, including `reviewSubmissions.state`, `reviewSubmissions.platform`. The optional field `appAvailabilityV2` is also now available.
- The [`Read app store version information`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_) endpoint now includes `gameCenterAppVersions` fields.
- The [`List all price points for a subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-pricePoints) endpoint now requires a `territory` filter.
- The `purchaseRequirement` attribute for [`AppEvent.Attributes`](/documentation/AppStoreConnectAPI/AppEvent/Attributes-data.dictionary) now correctly shows as a `string` type.

### Deprecations

- The `app` relationship to [`Create an app encryption declaration`](/documentation/AppStoreConnectAPI/POST-v1-appEncryptionDeclarations) has been deprecated.
- The [Promoted Purchase Images](/documentation/AppStoreConnectAPI/promoted-purchase-images) endpoints have been deprecated and replaced with [Subscription images](/documentation/AppStoreConnectAPI/subscription-images) and [In-App Purchase images](/documentation/AppStoreConnectAPI/in-app-purchase-images).

### Removals

- The duration `ONE_DAY` has been removed from [`SubscriptionOfferDuration`](/documentation/AppStoreConnectAPI/SubscriptionOfferDuration).

---

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)