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

# App Store Connect API 3.7 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.7 provides resources that enable you to automate actions you take in App Store Connect.

### New Features

- Developers now need to provide a description for all beta localizations before submitting to beta app review for external testing with TestFlight. You can update `betaAppLocalizations` with [`Modify a beta app localization`](/documentation/AppStoreConnectAPI/PATCH-v1-betaAppLocalizations-_id_).
- Added `WIN_BACK_ELIGIBILITY` report type to [`Download sales and trends reports`](/documentation/AppStoreConnectAPI/GET-v1-salesReports).
- Name is now a required field when using [`Create an app info localization`](/documentation/AppStoreConnectAPI/POST-v1-appInfoLocalizations). To see other attributes you can create or modify, see  [`AppInfoLocalizationCreateRequest.Data.Attributes`](/documentation/AppStoreConnectAPI/AppInfoLocalizationCreateRequest/Data-data.dictionary/Attributes-data.dictionary).
- Developers can now look up in-app purchase price point equalization using [`List All In-App Purchase Price Point Equalizations`](/documentation/AppStoreConnectAPI/GET-v1-inAppPurchasePricePoints-_id_-equalizations).
- The enum `UNIVERSAL` is now added to [`BundleIdPlatform`](/documentation/AppStoreConnectAPI/BundleIdPlatform). To learn more, see [Preparing your app for distribution](https://developer.apple.com/documentation/xcode/preparing-your-app-for-distribution/#Set-the-bundle-ID).
- The enums `DEVELOPER_ID_APPLICATION_G2` and `DEVELOPER_ID_KEXT_G2` are now available when using [`CertificateType`](/documentation/AppStoreConnectAPI/CertificateType). To learn more, see [Notarizing macOS software before distribution](https://developer.apple.com/documentation/security/notarizing-macos-software-before-distribution) and [macOS Code Signing Tips and Tricks](https://developer.apple.com/library/archive/technotes/tn2206/_index.html#//apple_ref/doc/uid/DTS40007919).
- You can now read age ratings for France by using [`Read app info information`](/documentation/AppStoreConnectAPI/GET-v1-appInfos-_id_).
- The [`Read an App’s Alternative Distribution Key`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-alternativeDistributionKey) endpoint now shows multiple distribution keys when you have multiple configured.
- There is a new required attribute `defaultFormatter` when you use [`Create a Leaderboard`](/documentation/AppStoreConnectAPI/POST-v1-gameCenterLeaderboards), which gives all your localizations the same formatter. To learn more, see [`GameCenterLeaderboardCreateRequest.Data.Attributes`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardCreateRequest/Data-data.dictionary/Attributes-data.dictionary).

### Deprecations

- The attribute `previewImage` on [`AppPreview.Attributes`](/documentation/AppStoreConnectAPI/AppPreview/Attributes-data.dictionary) is deprecated. Use `previewFrameImage` and [`PreviewFrameImage`](/documentation/AppStoreConnectAPI/PreviewFrameImage) instead.
- The attribute `assetDeliveryState` on [`AppPreview.Attributes`](/documentation/AppStoreConnectAPI/AppPreview/Attributes-data.dictionary) is deprecated. Use `videoDeliveryState` and [`AppMediaVideoState`](/documentation/AppStoreConnectAPI/AppMediaVideoState) instead.
- The attribute `previewImage` on [`AppEventVideoClip.Attributes`](/documentation/AppStoreConnectAPI/AppEventVideoClip/Attributes-data.dictionary) is deprecated. Use `previewFrameImage` and [`PreviewFrameImage`](/documentation/AppStoreConnectAPI/PreviewFrameImage) instead.
- The attribute `assetDeliveryState` on [`AppEventVideoClip.Attributes`](/documentation/AppStoreConnectAPI/AppEventVideoClip/Attributes-data.dictionary) is deprecated. Use `videoDeliveryState` and [`AppMediaVideoState`](/documentation/AppStoreConnectAPI/AppMediaVideoState) instead.
- The attribute `appStoreState` on [`AppInfo.Attributes`](/documentation/AppStoreConnectAPI/AppInfo/Attributes-data.dictionary) is deprecated. Use `state` instead.
- The attribute `appStoreState` on [`AppStoreVersion.Attributes`](/documentation/AppStoreConnectAPI/AppStoreVersion/Attributes-data.dictionary) is deprecated. Use `appVersionState` and [`AppVersionState`](/documentation/AppStoreConnectAPI/AppVersionState) instead.
- The relationship `groupLeaderboardSet` on [`GameCenterLeaderboardSet.Relationships`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardSet/Relationships-data.dictionary) is deprecated.
- The relationship `groupAchievement` on [`GameCenterAchievement.Relationships`](/documentation/AppStoreConnectAPI/GameCenterAchievement/Relationships-data.dictionary) is deprecated.
- The relationship `groupLeaderboard` on [`GameCenterLeaderboard.Relationships`](/documentation/AppStoreConnectAPI/GameCenterLeaderboard/Relationships-data.dictionary) is deprecated.

### Removals

- The `v1/appPreOrders` and `v1/appAvailabilities` resources are removed and replaced with `v2/appAvailabilities`. To learn more, see [App availability](/documentation/AppStoreConnectAPI/app-availability).
- `WATCH_SERIES_4` and `WATCH_SERIES_3` enums are removed from [`PreviewType`](/documentation/AppStoreConnectAPI/PreviewType).
- The `subscription` include for [`Read the availability of a subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionAvailabilities-_id_) is removed.

---

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)