<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/customer-reviews",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Customer Reviews"
}
-->

# Customer Reviews

Get the customer reviews for your app.

## Discussion

The `customerReviews` resource represents the ratings and reviews that customers write for your app that the App Store displays. Customers can provide reviews for your app in the App Store, or when your app requests a review. For more information about reviews, see [Ratings, Reviews, and Responses](https://developer.apple.com/app-store/ratings-and-reviews/).

Use this API to read the customer reviews for your app as follows:

- Call the [`List all customer reviews for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-customerReviews) endpoint to get all customer reviews for your app. Filter the reviews by territory and rating, and sort them by date or rating. You can also get a list of the reviews with or without published responses.
- Call the [`List all customer reviews for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-customerReviews) endpoint to get the customer reviews for a specific app version.
- Call the [`Read customer review information`](/documentation/AppStoreConnectAPI/GET-v1-customerReviews-_id_) endpoint using the resource ID of the review to read the details of a specific review.

To manage your responses to the customers reviews, use the endpoints in [Customer Review Responses](/documentation/AppStoreConnectAPI/customer-review-responses). For example, call [`Get a customer review response`](/documentation/AppStoreConnectAPI/GET-v1-customerReviews-_id_-response) using the resource ID of the customer review to read your response to that review.

## Topics

### Getting customer reviews for an app or app version

[`List all customer reviews for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-customerReviews)

Get a list of customer reviews for a specific app.

[`List customer review IDs for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-relationships-customerReviews)

[`List all customer reviews for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-customerReviews)

Get a list of customer reviews for a specific version of your app.

### Reading customer reviews

[`Read customer review information`](/documentation/AppStoreConnectAPI/GET-v1-customerReviews-_id_)

Get information about a specific customer review, including the review content.

### Reading review summariztions

[`Read Customer Review Summarizations`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-customerReviewSummarizations)

Get the customer review summarization for a specific app.

### Objects

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

The response body for endpoints that list customer reviews for an app.

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

The response body for endpoints that read a single customer review for an app.

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

A customer’s rating and written review of your app on the App Store.

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

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

An AI-generated summary of customer reviews for an app in a specific App Store territory.

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

A response containing a list of AI-generated review summaries for an app across territories.


---

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)