---
title: "Submit Price Feedback"
method: POST
path: "/api/v1/gems/{gem_id}/price-feedback"
tags: ["Gemstones"]
---

# Submit Price Feedback

`POST /api/v1/gems/{gem_id}/price-feedback`

## Request

- Base URL: `https://api.gemstoneaiapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemstoneaiapp.com/api/v1/gems/{gem_id}/price-feedback`
- Auth: HTTP bearer

POST /api/v1/gems/{gem_id}/price-feedback — consumer 👍👎 on a scan's valuation.

Captures whether the user thinks the estimated price is too low / about right
/ too high, plus an optional own-price guess. Persisted to scan_price_feedback
as a labeled example (with the scan's price context) for future pricing eval
and the consumer 👍👎 UI (app pair feat/2026-06-09-price-feedback-ui, LNK-PFB).

Auth required; users can only give feedback on their own gems. Idempotent per
gem: the latest verdict for a gem wins (re-tapping updates the same row rather
than appending), so the table stays one consumer-label row per gemstone.

Body:
- verdict: "too_low" | "about_right" | "too_high"
- user_estimate: optional number (the user's own price guess, USD)

Returns the saved scan_price_feedback row.

## Path parameters

- `gem_id` integer, required

## Request body

- PriceFeedbackRequest: Body for POST /api/v1/gems/{gem_id}/price-feedback.
  - `verdict` 'too_low' | 'about_right' | 'too_high', required
  - `user_estimate` number, nullable

## Response `200`

Successful Response

- PriceFeedbackResponse: The saved scan_price_feedback row.
  - `id` integer, required
  - `gemstone_id` integer, nullable
  - `species` string, required
  - `user_verdict` string, nullable
  - `user_estimate` number, nullable
  - `estimated_price_min` number, nullable
  - `estimated_price_max` number, nullable
  - `market_price` number, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api.md) · [All operations](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/revisions/fcb441f55161?raw)