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

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

### New Features

- The [Merchant ID](/documentation/AppStoreConnectAPI/merchantids) resource is now available to automate tasks related to Apple Pay and Apple Wallet. Apple Pay certificates now have enum values on the `certificates` resource.
- [`Modify a Certificate`](/documentation/AppStoreConnectAPI/PATCH-v1-certificates-_id_) is now available. Use this endpoint to modify the activation status of your Payment Processing certificate. To learn more, see [Managing merchant IDs and Payment Processing certificates](/documentation/AppStoreConnectAPI/managing-payment-processing-certificates).
- Create public links that accept testers with specific device and OS combinations using the `betaRecruitmentCriteria` resource. To learn more, see [Beta recruitment criteria](/documentation/AppStoreConnectAPI/beta-recruitment-criteria).
- Use the new `nominations` resource to share your new content, app enhancement, or app launch with Apple. To learn more see, [Getting featured on the App Store](https://developer.apple.com/app-store/getting-featured/).
- Three new content statuses, `TRADER_STATUS_NOT_PROVIDED`, `TRADER_STATUS_VERIFICATION_FAILED`, and `TRADER_STATUS_VERIFICATION_STATUS_MISSING` are available for [`TerritoryAvailability.Attributes`](/documentation/AppStoreConnectAPI/TerritoryAvailability/Attributes-data.dictionary). To learn more, see [Manage European Union Digital Services Act trader requirements](https://developer.apple.com/help/app-store-connect/manage-compliance-information/manage-european-union-digital-services-act-trader-requirements).

### Improvements

- The field `iosBuildsAvailableForAppleVision` is now in the [Beta Groups](/documentation/AppStoreConnectAPI/beta-groups) resource.

### Deprecations

- The attribute `brazilAgeRatings` for [`AppInfo.Attributes`](/documentation/AppStoreConnectAPI/AppInfo/Attributes-data.dictionary) is deprecated. Use `brazilAgeRatingV2` instead.

### Removals

- The `PromotedPurchaseImages` resources is now removed and replaced with [Subscription images](/documentation/AppStoreConnectAPI/subscription-images) and [In-App Purchase images](/documentation/AppStoreConnectAPI/in-app-purchase-images).
- The enum `ELAPSED_TIME_MILLISECOND` is now removed from [`GameCenterLeaderboardFormatter`](/documentation/AppStoreConnectAPI/GameCenterLeaderboardFormatter).

---

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)