---
title: "Leave a verified-purchase vendor review"
method: POST
path: "/v1/orders/{id}/review"
---

# Leave a verified-purchase vendor review

`POST /v1/orders/{id}/review`

## Request

- Base URL: `https://agenticfabricationnetwork.ai`
- URL: `https://agenticfabricationnetwork.ai/v1/orders/{id}/review`
- Auth: HTTP bearer

Reviews require possession of the order id (verified purchases only) and the order must be paid. One review per order — submitting again updates the existing review. Ratings appear on offers as vendor_rating and feed offer ranking.

## Path parameters

- `id` string, required

## Request body

- object
  - `stars` integer, required
  - `comment` string: Optional short factual comment
  - `facets` object: Optional 1-5 sub-scores; include only facets the buyer spoke to
    - `quality` integer
    - `timeliness` integer
    - `accuracy` integer

## Response `201`

Review recorded (or updated)

- object
  - `review_id` string
  - `order_id` string
  - `vendor_display_name` string
  - `stars` integer
  - `status` 'pending' | 'active'

## Other responses

- `400`: Order not paid yet, or invalid stars/facets
- `404`: Unknown order id

---

[API](https://skmtc.dev/agenticfabricationnetwork/apis/afn-agentic-fabrication-network.md) · [All operations](https://skmtc.dev/agenticfabricationnetwork/apis/afn-agentic-fabrication-network/llms.txt) · [OpenAPI document](https://skmtc.dev/agenticfabricationnetwork/apis/afn-agentic-fabrication-network/revisions/42c16babcd2b?raw)