<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/alternative-distribution-packages",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Alternative Distribution Packages"
}
-->

# Alternative Distribution Packages

Create and read distribution packages for an alternative app distribution.

## Discussion

App developers can get alternative distribution package IDs through the App Store Connect API by using [`Read an app store version’s alternative distribution package`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-alternativeDistributionPackage). You can also get the IDs in App Store Connect, to learn more, see [Get an alternative distribution package ID](https://developer.apple.com/help/app-store-connect/distributing-apps-in-the-european-union/get-an-alternative-distribution-package-id).

The alternative distribution package ID is valid for distributing a marketplace app, an app on an alternative marketplace, or through web distribution. To learn more about creating alternative distribution packages, see [Creating alternative distribution packages](/documentation/AppStoreConnectAPI/creating-alternative-distribution-packages).

To learn more about ingesting alternative distribution packages as a marketplace, see <doc://com.apple.documentation/documentation/marketplacekit/processing-alternative-marketplace-notifications>.

## Topics

### Creating and reading distribution packages

[Creating alternative distribution packages](/documentation/AppStoreConnectAPI/creating-alternative-distribution-packages)

Create distribution packages for your apps that you distribute on alternative marketplaces or on the web.

[`GET /v1/alternativeDistributionPackages/{id}`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackages-_id_)

Get information about a specific alternative distribution package.

[`POST /v1/alternativeDistributionPackages`](/documentation/AppStoreConnectAPI/POST-v1-alternativeDistributionPackages)

Create an alternative distribution package for an App Store version.

[`GET /v1/appStoreVersions/{id}/alternativeDistributionPackage`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-alternativeDistributionPackage)

Read the alternative distribution package for a specific App Store version.

[`GET /v1/alternativeDistributionPackages/{id}/versions`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackages-_id_-versions)

Get version detail information about a specific alternative distribution package.

### Getting version information

[`GET /v1/alternativeDistributionPackageVersions/{id}`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackageVersions-_id_)

Get detail information about a specific alternative distribution package version.

[`GET /v1/alternativeDistributionPackages/{id}/versions`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackages-_id_-versions)

Get version detail information about a specific alternative distribution package.

[`GET /v1/alternativeDistributionPackageVersions/{id}/deltas`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackageVersions-_id_-deltas)

List deltas for a specific alternative distribution package version.

[`GET /v1/alternativeDistributionPackageVersions/{id}/variants`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackageVersions-_id_-variants)

List variants for specific alternative distribution package version.

[`GET /v1/alternativeDistributionPackageVersions/{id}/relationships/deltas`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackageVersions-_id_-relationships-deltas)

List all delta Ids for a specific alternative distribution package version.

[`GET /v1/alternativeDistributionPackageVersions/{id}/relationships/variants`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackageVersions-_id_-relationships-variants)

List variant Ids for specific alternative distribution package version.

[`GET /v1/alternativeDistributionPackages/{id}/relationships/versions`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackages-_id_-relationships-versions)

Get version IDs about a specific alternative distribution package.

### Getting delta information

[`GET /v1/alternativeDistributionPackageDeltas/{id}`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackageDeltas-_id_)

Get detail information about specific alternative distribution package deltas.

[`GET /v1/alternativeDistributionPackageVersions/{id}/deltas`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackageVersions-_id_-deltas)

List deltas for a specific alternative distribution package version.

### Getting variant information

[`GET /v1/alternativeDistributionPackageVariants/{id}`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackageVariants-_id_)

Get detail information about specific alternative distribution package variants.

[`GET /v1/alternativeDistributionPackageVersions/{id}/variants`](/documentation/AppStoreConnectAPI/GET-v1-alternativeDistributionPackageVersions-_id_-variants)

List variants for specific alternative distribution package version.

### Objects

[`AlternativeDistributionPackage`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackage)

The distributable package for an app on an alternative marketplace or web distribution, containing versioned variants and delta updates.

[`AlternativeDistributionPackageCreateRequest`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageCreateRequest)

The request body you use to create an alternative distribution package.

[`AlternativeDistributionPackageResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageResponse)

The response body for endpoints that read a single alternative distribution package.

[`AlternativeDistributionPackageVersion`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageVersion)

A versioned snapshot of an alternative distribution package, containing its variants and delta updates.

[`AlternativeDistributionPackageVersionResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageVersionResponse)

The response body for endpoints that read a single alternative distribution package version.

[`AlternativeDistributionPackageVersionsResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageVersionsResponse)

The response body for endpoints that list versions of an alternative distribution package.

[`AlternativeDistributionPackageDelta`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageDelta)

An incremental update package for an alternative distribution app, containing only the changes between two versions to reduce download size.

[`AlternativeDistributionPackageDeltaResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageDeltaResponse)

A response containing a single delta update for an alternative distribution package.

[`AlternativeDistributionPackageDeltasResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageDeltasResponse)

A response containing a list of delta updates available for an alternative distribution package.

[`AlternativeDistributionPackageVariant`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageVariant)

A device-specific file package within an alternative distribution app, targeting a particular device family.

[`AlternativeDistributionPackageVariantResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageVariantResponse)

A response containing a single variant of an alternative distribution package.

[`AlternativeDistributionPackageVariantsResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageVariantsResponse)

A response containing a list of device-specific variants within an alternative distribution package.

[`AlternativeDistributionPackageVersionDeltasLinkagesResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageVersionDeltasLinkagesResponse)

[`AlternativeDistributionPackageVersionVariantsLinkagesResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageVersionVariantsLinkagesResponse)

[`AlternativeDistributionPackageVersionsLinkagesResponse`](/documentation/AppStoreConnectAPI/AlternativeDistributionPackageVersionsLinkagesResponse)



---

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)