---
title: "Review data model"
url: "https://docs.unified.to/commerce/review/model"
description: "API reference for Review data model. Launch multiple pre-built Review integrations today with zero maintenance — all through a single API."
generated_at: "2026-06-03T19:03:01.677Z"
---
# Review data model

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](/commerce/integrations) page. 

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string 

**created\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**item\_id**string 

Reference to the product being reviewed (reference to CommerceItem)

**item\_variant\_id**string 

Optional reference to specific variant if applicable (reference to CommerceCommerceItemvariant)

**location\_id**string 

(reference to CommerceLocation)

**rating**number 

1-5 rating

**title**string 

**content**string 

**author\_name**string 

**author\_email**string 

**author\_avatar\_url**string 

**author\_location**string 

**verified\_purchase**boolean 

**helpful\_votes**number 

**unhelpful\_votes**number 

**media** array 

Photosvideos attached to the review

**status** enum

Valid values:

 "PENDING" 

 "APPROVED" 

 "REJECTED" 

 "SPAM" 

**is\_verified**boolean 

**is\_featured**boolean 

**is\_public**boolean 

**comments** array 

**metadata** array 

**url**string 

**raw**any 

Original review data from source platform