<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/in-app-purchase-versions",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "In-App Purchase Versions"
}
-->

# In-App Purchase Versions

Create and read draft versions of an In-App Purchase, with their localized metadata and review images.

## Discussion

Each In-App Purchase has a version, which is the container for the localizations and images related to that In-App Purchase. Use the In-App Purchase version for submitting to review.

## Topics

### Endpoints

[`Create an In-App Purchase version`](/documentation/AppStoreConnectAPI/POST-v1-inAppPurchaseVersions)

Create a draft version of an In-App Purchase, capturing its current localized metadata and review images for App Review submission.

[`Read In-App Purchase version information`](/documentation/AppStoreConnectAPI/GET-v1-inAppPurchaseVersions-_id_)

Get information about a specific draft version of an In-App Purchase.

[`Read the image for an In-App Purchase version`](/documentation/AppStoreConnectAPI/GET-v1-inAppPurchaseVersions-_id_-image)

Get the review image attached to a draft version of an In-App Purchase.

[`List images for an In-App Purchase version`](/documentation/AppStoreConnectAPI/GET-v1-inAppPurchaseVersions-_id_-images)

List the review images attached to a draft version of an In-App Purchase.

[`List localizations for an In-App Purchase version`](/documentation/AppStoreConnectAPI/GET-v1-inAppPurchaseVersions-_id_-localizations)

List the localized display names and descriptions captured in a draft version of an In-App Purchase.

[`Read the image ID for an In-App Purchase version`](/documentation/AppStoreConnectAPI/GET-v1-inAppPurchaseVersions-_id_-relationships-image)

Get the related resource ID for the review image attached to a draft version of an In-App Purchase.

[`List image IDs for an In-App Purchase version`](/documentation/AppStoreConnectAPI/GET-v1-inAppPurchaseVersions-_id_-relationships-images)

Get the related resource IDs for the review images attached to a draft version of an In-App Purchase.

[`List localization IDs for an In-App Purchase version`](/documentation/AppStoreConnectAPI/GET-v1-inAppPurchaseVersions-_id_-relationships-localizations)

Get the related resource IDs for the localizations captured in a draft version of an In-App Purchase.

[`List the versions of an In-App Purchase`](/documentation/AppStoreConnectAPI/GET-v2-inAppPurchases-_id_-versions)

List the draft versions of an In-App Purchase configured with the v2 API.

[`Get the resource IDs of the versions of an In-App Purchase`](/documentation/AppStoreConnectAPI/GET-v2-inAppPurchases-_id_-relationships-versions)

Get the related resource IDs for the draft versions of an In-App Purchase configured with the v2 API.

### Objects

[`object InAppPurchaseVersion`](/documentation/AppStoreConnectAPI/InAppPurchaseVersion)

A draft version of an In-App Purchase that captures its localized metadata and review images for App Review submission.

[`object InAppPurchaseVersionCreateRequest`](/documentation/AppStoreConnectAPI/InAppPurchaseVersionCreateRequest)

The request body you use to create a draft version of an In-App Purchase.

[`object InAppPurchaseVersionImageLinkageResponse`](/documentation/AppStoreConnectAPI/InAppPurchaseVersionImageLinkageResponse)

A response containing the resource identifier of the review image for an In-App Purchase version.

[`object InAppPurchaseVersionImagesLinkagesResponse`](/documentation/AppStoreConnectAPI/InAppPurchaseVersionImagesLinkagesResponse)

A response containing the resource identifiers of the review images for an In-App Purchase version.

[`object InAppPurchaseVersionLocalizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/InAppPurchaseVersionLocalizationsLinkagesResponse)

A response containing the resource identifiers of the localizations for an In-App Purchase version.

[`object InAppPurchaseVersionResponse`](/documentation/AppStoreConnectAPI/InAppPurchaseVersionResponse)

The response body for endpoints that create or read an In-App Purchase version.

[`object InAppPurchaseVersionsResponse`](/documentation/AppStoreConnectAPI/InAppPurchaseVersionsResponse)

The response body for endpoints that list In-App Purchase versions.

[`object InAppPurchaseV2VersionsLinkagesResponse`](/documentation/AppStoreConnectAPI/InAppPurchaseV2VersionsLinkagesResponse)

A response containing the resource identifiers of the versions of an In-App Purchase configured with the v2 API.



---

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)