Read App Store customer reviews and publish, replace or delete a developer response via the App Store Connect API

Documented steps

1. Authenticate with Authorization: Bearer <JWT>.
2. Get the app resource id via GET /v1/apps (filter[bundleId] if needed).
3. List reviews: GET https://api.appstoreconnect.apple.com/v1/apps/{id}/customerReviews, optionally with filter[territory] (array of ISO territory codes such as USA, GBR, JPN) and filter[rating] (array of integers 1-5).
4. Sort newest-first with sort=-createdDate. Valid sort values are createdDate, -createdDate, rating, -rating.
5. Paginate with limit (max 200) and follow links.next; meta.paging.total gives the full count.
6. Trim the payload with fields[customerReviews]=rating,title,body,reviewerNickname,createdDate,territory,response and use include=response to embed any existing reply in the same call.
7. Read each review's attributes: rating (int), title, body, reviewerNickname, createdDate (ISO 8601), territory.
8. Detect reviews that already have a reply using the exists[publishedResponse] filter, or follow GET /v1/customerReviews/{id}/response.
9. Publish a reply: POST https://api.appstoreconnect.apple.com/v1/customerReviewResponses with {"data":{"type":"customerReviewResponses","attributes":{"responseBody":"Thanks for the feedback! We fixed this in v2.1."},"relationships":{"review":{"data":{"type":"customerReviews","id":"00000028-b08c-0014-729e-fbd500000000"}}}}}
10. A successful POST returns 201 with attributes.state of PENDING_PUBLISH or PUBLISHED, plus lastModifiedDate.
11. To CHANGE a reply, POST again to /v1/customerReviewResponses with the same review relationship. Apple documents this call as creating a new response or replacing the existing one — there is no PATCH endpoint.
12. To remove a reply entirely: DELETE https://api.appstoreconnect.apple.com/v1/customerReviewResponses/{id}
13. Verify publication with GET /v1/customerReviewResponses/{id} and check attributes.state == PUBLISHED before considering the task complete.
14. Official docs: https://developer.apple.com/documentation/appstoreconnectapi/get-v1-apps-_id_-customerreviews | https://developer.apple.com/documentation/appstoreconnectapi/customer-review-responses | https://developer.apple.com/documentation/appstoreconnectapi/post-v1-customerreviewresponses