<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/review-submissions",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Review submissions"
}
-->

# Review submissions

Create and manage your submissions for review, which can include your App Store version, App Store version experiments, custom product page versions, and in-app events.

## Discussion

The attribute `platform` is no longer required when using [`Create a Review Submission`](/documentation/AppStoreConnectAPI/POST-v1-reviewSubmissions). You can optionally add the attribute platform when using [`Modify a Review Submission`](/documentation/AppStoreConnectAPI/PATCH-v1-reviewSubmissions-_id_).

## Topics

### Endpoints

[`List Review Submissions for an App`](/documentation/AppStoreConnectAPI/GET-v1-reviewSubmissions)

List recent and current review submissions for a specific app.

[`Read Review Submission Information`](/documentation/AppStoreConnectAPI/GET-v1-reviewSubmissions-_id_)

Read information about a specific review submisison.

[`List the Items in a Review Submission`](/documentation/AppStoreConnectAPI/GET-v1-reviewSubmissions-_id_-items)

List all the items in a specific review submission.

[`List item IDs`](/documentation/AppStoreConnectAPI/GET-v1-reviewSubmissions-_id_-relationships-items)

Get the list of item IDs for a specific review submission.

[`List review submission IDs`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-relationships-reviewSubmissions)

Get the list of review submission IDs for a specific app.

[`Modify a Review Submission`](/documentation/AppStoreConnectAPI/PATCH-v1-reviewSubmissions-_id_)

Edit the details or contents of a review submission.

[`Create a Review Submission`](/documentation/AppStoreConnectAPI/POST-v1-reviewSubmissions)

Create a review submission for a specific app.

### Objects

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

A formal submission to App Store review grouping one or more items — app versions, in-app purchases, or events — for simultaneous review.

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

An individual reviewable item — such as an app version, in-app purchase, or App Clip — included in a review submission.

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

The request body you use to update a review submission update request.

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

The request body for creating a review submission for an App Store version or associated items.

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

The response body for endpoints that create, read, or modify a single review submission.

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

The response body for endpoints that list review submissions for an app.

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

A response containing the resource identifiers of review submissions associated with an app.

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

A response containing the resource identifiers of items included in a review submission.


---

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)