--- title: List all customer reviews for an app framework: appstoreconnectapi role: symbol role_heading: Web Service Endpoint path: appstoreconnectapi/get-v1-apps-_id_-customerreviews --- # List all customer reviews for an app Get a list of customer reviews for a specific app. ## URL GET https://api.appstoreconnect.apple.com/v1/apps/{id}/customerReviews ## Path Parameters id: The opaque resource ID that uniquely identifies the apps resource that represents your app. Obtain the app resource ID from the List apps response. ## Query Parameters fields[customerReviewResponses]: Fields to return for the included related types. fields[customerReviews]: Fields to return for the included related types. filter[rating]: An array of numerical rating values by which to filter. For example, filtering for 1,2,5 shows only reviews with ratings of 1, 2, or 5. The minimum numeric rating value is 1, and the maximum is 5. include: Relationship data to include in the response. limit: Number of resources to return. sort: Attributes by which to sort. Supports one sort parameter at a time. filter[territory]: A filter of territories to include in the response. exists[publishedResponse]: A Boolean value that filters the reviews based on whether the review has a published response in the App Store. Use true to return the customer reviews that already have a published response in the App Store. Use false to return the customer reviews that don’t have a published response. Note that it’s possible that a review has a response that isn’t yet published. fields[territories]: filter[reviewTerritory]: ## Response Codes 200 OK: 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 404 Not Found: Resource not found. 429 : ## Discussion Discussion The example below limits the number of reviews returned in the response. Example Request and Response ## See Also ### Getting customer reviews - [List customer review IDs for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-customerreviews.md) - [Read Customer Review Summarizations](appstoreconnectapi/get-v1-apps-_id_-customerreviewsummarizations.md)