Skip to content
SupaCloud Docs
Select themeSelect language

`GET /api/marketplace/items/{id}/ratings?limit&offset` — PUBLIC paginated list of an item's customer ratings (most recent first) + the total count.

GET
/api/marketplace/items/{id}/ratings
curl --request GET \
  --url https://example.com/api/marketplace/items/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/ratings

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Query Parameters

Section titled “Query Parameters”
limit
integer format: int64
offset
integer format: int64

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json

One page of an item’s customer ratings + the total count (for pagination).

object
facets
required

Reserved facet extension for the public ratings board. Empty today, but present so paginated/list endpoints share the {items,total,facets} envelope.

object
items
required
Array<object>

ADR 0034 #351 — a customer (buyer/installer) star rating + optional short comment for a marketplace item. One row per (item_id, workspace_id); only a workspace that has installed the item may rate it (enforced in the service). ORTHOGONAL to MarketplaceItemReview (the owner-gated moderation gate).

object
comment
string | null
created_at
required
string format: date-time
id
required
string format: uuid
item_id
required
string format: uuid
stars
required
integer format: int32
updated_at
required
string format: date-time
total
required
integer format: int64
Examplegenerated
{
  "facets": {},
  "items": [
    {
      "comment": "example",
      "created_at": "2026-04-15T12:00:00Z",
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "item_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "stars": 1,
      "updated_at": "2026-04-15T12:00:00Z"
    }
  ],
  "total": 1
}