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

# Customer Review Responses

Get, create, update, and delete your responses to customer reviews.

## Discussion

The `customerReviewResponses` resource represents your responses to customer reviews for apps you publish on the App Store. Each customer review can have at most one review response.

Use this API to get, create, update, and delete your responses to customer reviews for your app. First, get a list of customer reviews, including their resource IDs, by calling the [`List all customer reviews for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-customerReviews) or [`List all customer reviews for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-customerReviews) endpoints. Next use this API as follows:

- Respond to a customer review by calling [`Create or update a response to a customer review`](/documentation/AppStoreConnectAPI/POST-v1-customerReviewResponses) using the review’s resource ID. Update your existing review using the same endpoint.
- Get your existing review response by calling [`Get a customer review response`](/documentation/AppStoreConnectAPI/GET-v1-customerReviews-_id_-response), using the resource ID of the customer review.
- Delete your response to a customer review by calling [`Delete a response to a customer review`](/documentation/AppStoreConnectAPI/DELETE-v1-customerReviewResponses-_id_), using the resource ID of your response.

For more information about reviews, see [Ratings, Reviews, and Responses](https://developer.apple.com/app-store/ratings-and-reviews/).

## Topics

### Getting Review Responses

[`Get a customer review response`](/documentation/AppStoreConnectAPI/GET-v1-customerReviews-_id_-response)

Get the response to a specific customer review.

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

Get information about a specific response you wrote to a customer review, including the response content and its state.

[`Get the response ID for a customer review`](/documentation/AppStoreConnectAPI/GET-v1-customerReviews-_id_-relationships-response)

### Creating, Updating, and Deleting Review Responses

[`Create or update a response to a customer review`](/documentation/AppStoreConnectAPI/POST-v1-customerReviewResponses)

Create a response or replace an existing response you wrote to a customer review.

[`Delete a response to a customer review`](/documentation/AppStoreConnectAPI/DELETE-v1-customerReviewResponses-_id_)

Delete a specific response you wrote to a customer review.

### Objects and types

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

The response body for endpoints that create, read, or modify a developer’s response to a customer review.

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

A developer’s public reply to a customer review on the App Store.

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

The request body to use to create a response to a customer review.

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

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

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

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


---

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)