<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-store-review-details",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Store review details"
}
-->

# App Store review details

Manage the required information you provide for App Review.

## Discussion

Use `appStoreReviewDetails` to provide information required for App Review. This information isn’t displayed on the App Store. Required attributes for App Review are:

- Contact first and last name
- Contact phone number
- Contact email address
- Whether testing your app requires a demo account
- Demo account name (if your app uses a single sign-on service)
- Demo account password (if your app uses a single sign-on service)

Optionally, provide notes for the review team using the notes attribute. If you need to attach a file for App Review, use the [App Store review attachments](/documentation/AppStoreConnectAPI/app-store-review-attachments) resource.

For more information see [App Review information](https://developer.apple.com/help/app-store-connect/reference/app-review-information).

## Topics

### Creating, Modifying, and Reading Review Details

[`Create an app store review detail`](/documentation/AppStoreConnectAPI/POST-v1-appStoreReviewDetails)

Add App Store review details to an App Store version, including contact and demo account information.

[`Read app store review detail information`](/documentation/AppStoreConnectAPI/GET-v1-appStoreReviewDetails-_id_)

Get App Review details you provided, including contact information, demo account, and notes.

[`List App Store review attachment IDs for an App Store review detail`](/documentation/AppStoreConnectAPI/GET-v1-appStoreReviewDetails-_id_-relationships-appStoreReviewAttachments)

[`Modify an app store review detail`](/documentation/AppStoreConnectAPI/PATCH-v1-appStoreReviewDetails-_id_)

Update the App Store review details, including the contact information, demo account, and notes.

### Objects

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

The data structure that represent an App Store Review Details  resource.

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

The request body you use to create an App Store Review Detail.

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

The request body you use to update an App Store Review Detail.

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

The response body for endpoints that read or modify App Store review details for a version.

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


---

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)