List all reviews

GET https://api.tamio.com/v2/reviews/list

Returns a paginated list of product reviews. Supports filtering by product, customer, invoice, date range, verified-customer flag, and free-text search across review content and reviewer names.

Query Parameters

page integer*

Page number for pagination.

per_page integer*

Number of reviews per page.

order string

Sort direction.

ascdesc

sort_by string

Field to sort by.

created_at

from string

Start date filter (ISO 8601 string or Unix timestamp as string).

to string

End date filter (ISO 8601 string or Unix timestamp as string).

product_id string

Filter reviews by product UUID.

customer_id string

Filter reviews by customer UUID.

invoice_id string

Filter reviews by invoice UUID.

filter string

Free-text search across review content and reviewer names.

customer_reviews boolean

When true, return only verified customer reviews; when false, exclude them.

Responses

200 Paginated list of reviews

Paginated list of reviews

status integer

total_results integer

reviews array of Review

id string

Unique identifier of the review.

object string

Object type identifier.

name string

Name of the reviewer.

locale string

Locale of the review.

review_text string

Main review content.

rating integer

Star rating.

created_at integer

Unix timestamp of review creation.

image string

Public URL of the attached image, or null.

external_review string

URL to an external review document or image.

external_link string

External URL related to the review.

product object

Associated product summary.

id string

Product UUID.

name string

Product name.

customer object

Associated customer summary (when available).

id string

Customer UUID.

name string

Customer name.

email string

Customer email address.

customer_review boolean

Whether this is a verified customer review.

invoice object

Associated invoice summary (when available).

prefix string

Invoice prefix.

number integer

Invoice number.

date_bought integer

Unix timestamp of the purchase date.

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	Filtered resource (product, customer, or invoice) not found

status integer

error string

error_code integer

401 Missing or invalid API key

Create a review

/reviews/list

1 const response = await fetch("https://api.tamio.com/v2/reviews/list", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/reviews/list")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "total_results": 42,
  "reviews": [
    {
      "id": "999e4567-e89b-12d3-a456-426614174000",
      "object": "review",
      "name": "John Doe",
      "locale": "en",
      "review_text": "Excellent product, highly recommended!",
      "rating": 5,
      "created_at": 1718444400,
      "image": "https://cdn.tamio.com/assets/review-photo.jpg",
      "external_review": "https://example.com/review-screenshot.png",
      "external_link": "https://trustpilot.com/review/abc123",
      "product": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "Premium Widget"
      },
      "customer": {
        "id": "223e4567-e89b-12d3-a456-426614174000",
        "name": "Jane Smith",
        "email": "[email protected]"
      },
      "customer_review": true,
      "invoice": {
        "prefix": "INV",
        "number": 1042,
        "date_bought": 1717000000
      }
    }
  ]
}

1	const response = await fetch("https://api.tamio.com/v2/reviews/list", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/reviews/list")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body