# Reviews

Reviews are used to evaluate Products and Channels.

On the [tutorial page](https://docs.commercetools.com/tutorials/review-ratings.md) you can find some instructions on how to use Reviews to rate Products and Channels.

## Representations

#### Review

See API type definition [Review](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReview).

#### ReviewDraft

See API type definition [ReviewDraft](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewDraft).

#### ReviewPagedQueryResponse

See API type definition [ReviewPagedQueryResponse](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewPagedQueryResponse).

#### ReviewRatingStatistics

See API type definition [ReviewRatingStatistics](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewRatingStatistics).

#### ReviewReference

See API type definition [ReviewReference](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewReference).

#### ReviewResourceIdentifier

See API type definition [ReviewResourceIdentifier](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewResourceIdentifier).

## Get Review

### Get Review by ID

See API endpoint definition [GET /\{projectKey}/reviews/\{id}](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%2F%7Bid%7D%3AGET).

### Get Review by Key

See API endpoint definition [GET /\{projectKey}/reviews/key=\{key}](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%2Fkey%3D%7Bkey%7D%3AGET).

## Query Reviews

See API endpoint definition [GET /\{projectKey}/reviews](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%3AGET).

## Check if Review exists

### Check if Review exists by ID

See API endpoint definition [HEAD /\{projectKey}/reviews/\{id}](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%2F%7Bid%7D%3AHEAD).

### Check if Review exists by Key

See API endpoint definition [HEAD /\{projectKey}/reviews/key=\{key}](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%2Fkey%3D%7Bkey%7D%3AHEAD).

### Check if Review exists by Query Predicate

See API endpoint definition [HEAD /\{projectKey}/reviews](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%3AHEAD).

## Create Review

See API endpoint definition [POST /\{projectKey}/reviews](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%3APOST).

This method produces the [Review Created](https://docs.commercetools.com/api/projects/messages/product-catalog-messages.md#review-created) Message.

## Update Review

### Update Review by ID

See API endpoint definition [POST /\{projectKey}/reviews/\{id}](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%2F%7Bid%7D%3APOST).

### Update Review by Key

See API endpoint definition [POST /\{projectKey}/reviews/key=\{key}](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%2Fkey%3D%7Bkey%7D%3APOST).

## Update actions

#### Set Key

See API type definition [ReviewSetKeyAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetKeyAction).

#### Set Author Name

See API type definition [ReviewSetAuthorNameAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetAuthorNameAction).

#### Set Customer

See API type definition [ReviewSetCustomerAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetCustomerAction).

#### Set Rating

See API type definition [ReviewSetRatingAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetRatingAction).

#### Set Target

See API type definition [ReviewSetTargetAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetTargetAction).

#### Set Text

See API type definition [ReviewSetTextAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetTextAction).

#### Set Title

See API type definition [ReviewSetTitleAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetTitleAction).

#### Set Locale

See API type definition [ReviewSetLocaleAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetLocaleAction).

#### Transition State

See API type definition [ReviewTransitionStateAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewTransitionStateAction).

#### Set Custom Type

See API type definition [ReviewSetCustomTypeAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetCustomTypeAction).

#### Set CustomField

See API type definition [ReviewSetCustomFieldAction](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Atype%3AReviewSetCustomFieldAction).

## Delete Review

### Delete Review by ID

See API endpoint definition [DELETE /\{projectKey}/reviews/\{id}](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%2F%7Bid%7D%3ADELETE).

### Delete Review by Key

See API endpoint definition [DELETE /\{projectKey}/reviews/key=\{key}](https://docs.commercetools.com/api/projects/reviews.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Freviews%2Fkey%3D%7Bkey%7D%3ADELETE).

## Related pages

- [Section overview page](https://docs.commercetools.com/api.md)
- [Previous page: Categories](https://docs.commercetools.com/api/projects/categories.md)