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

# App Store Connect API 4.2 release notes

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

## Discussion

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

### New Features

- You can now submit Game Center content directly to review without including an app version by using [Review submissions](/documentation/AppStoreConnectAPI/review-submissions). Use [`Create a Review Submission Item`](/documentation/AppStoreConnectAPI/POST-v1-reviewSubmissionItems) to submit achievement versions, leaderboard versions, leaderboard set versions, activity versions, and challenge versions for independent review.
- Game Center resources now support versioning for achievements, leaderboards, and leaderboard sets. To learn more, see [Game Center achievements](/documentation/AppStoreConnectAPI/game-center-achievements), [Game Center leaderboards](/documentation/AppStoreConnectAPI/game-center-leaderboards), and [Game Center leaderboard sets](/documentation/AppStoreConnectAPI/game-center-leaderboard-sets).
- Added support for In-App Purchase offer codes for consumable, non-consumable, and non-renewing subscriptions. Create and manage promotional offer codes using [`Create an In-App Purchase Offer Code`](/documentation/AppStoreConnectAPI/POST-v1-inAppPurchaseOfferCodes), [`Create an In-App Purchase Offer Code Custom Code`](/documentation/AppStoreConnectAPI/POST-v1-inAppPurchaseOfferCodeCustomCodes), and [`Create an In-App Purchase Offer Code One-Time Use Code`](/documentation/AppStoreConnectAPI/POST-v1-inAppPurchaseOfferCodeOneTimeUseCodes). To learn more, see [In-App Purchase Offer Codes](/documentation/AppStoreConnectAPI/in-app-purchase-offers).
- The `appDevices` attribute is now available on the [`BetaTester.Attributes`](/documentation/AppStoreConnectAPI/BetaTester/Attributes-data.dictionary) resource, enabling you to view the device models used by beta testers for your app’s TestFlight testing.
- Background asset versions now include a `stateDetails` attribute that provides additional context about the asset state, including errors, warnings, and informational messages for failed imports. Access this information using [`Read background asset version information`](/documentation/AppStoreConnectAPI/GET-v1-backgroundAssetVersions-_id_).
- There is a new string `PAY_TO_PARK` available for `mapAction` when creating or modifying an App Clip advanced experience. To learn more, see [`AppClipAdvancedExperience.Attributes.Place`](/documentation/AppStoreConnectAPI/AppClipAdvancedExperience/Attributes-data.dictionary/Place-data.dictionary).
- You can now map your Android apps to your iOS apps using the [Android to iOS App Mapping](/documentation/AppStoreConnectAPI/android-to-ios-app-mapping) resource. This mapping enables data and app migration between Android and iOS devices during device setup. Use [`Create an Android to iOS App Mapping Detail`](/documentation/AppStoreConnectAPI/POST-v1-androidToIosAppMappingDetails) to create mappings with your Android app’s package name and signing certificate fingerprints.
- [Webhook notifications](/documentation/AppStoreConnectAPI/webhook-notifications) now includes events for alternative app distribution. To learn more see, [Configuring and parsing App Store Connect API webhook notifications](/documentation/AppStoreConnectAPI/configuring-webhook-notifications) and [Understanding webhook events](/documentation/AppStoreConnectAPI/webhook-events).
- Alternative distribution packages now include a `sourceFileChecksum` attribute, allowing alternative marketplaces to verify builds with developers. Use [`Read Alternative Distribution Package Information`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackages-_id_) to access the checksum of the developer-submitted package.

### Deprecations

- The `kidsAgeBand` attribute is now deprecated from [`AppInfo.Attributes`](/documentation/AppStoreConnectAPI/AppInfo/Attributes-data.dictionary). Use [`Modify an age rating declaration`](/documentation/AppStoreConnectAPI/PATCH-v1-ageRatingDeclarations-_id_) instead.
- The alternative distribution [Notifications](/documentation/AppStoreConnectAPI/notifications) are deprecated. Use [Webhook notifications](/documentation/AppStoreConnectAPI/webhook-notifications) instead. To learn more, see [Configuring and parsing App Store Connect API webhook notifications](/documentation/AppStoreConnectAPI/configuring-webhook-notifications) and [Understanding webhook events](/documentation/AppStoreConnectAPI/webhook-events)

### Removals

- The attribute `challengeEnabled` is now removed from [`Enable game center for an app`](/documentation/AppStoreConnectAPI/POST-v1-gameCenterDetails) and [`Modify a game center detail for an app`](/documentation/AppStoreConnectAPI/PATCH-v1-gameCenterDetails-_id_). To create a challenge on an existing Game Center detail, use [`Create a Challenge`](/documentation/AppStoreConnectAPI/POST-v1-gameCenterChallenges).

---

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)