Submit a review | Quotrr API docs

Creates a Prop against a verified, signed, completed job. Because this acts for a person, it requires a consent token signed by that homeowner. Props are permanent once the reversal window closes: they are part of the reputation record, not a marketing toggle.

Authentication

Bearer consent token with the review:write scope, naming the acting homeowner.

Scope: review:write

Request

Name	In	Required	Type	Description
Authorization	header	Required	string	Bearer .
verified_job_id	body	Required	string	The verified completed job the review is tied to.
rating	body	Required	integer	Overall rating, 1 to 5.
props	body	Optional	array	Tap-tag Props, e.g. ["On time", "Clean", "Fair price"].

Example request

curl -s -X POST https://api.quotrr.com/v1/reviews \
  -H "Authorization: Bearer <consent-token>" \
  -H "Content-Type: application/json" \
  -d '{"verified_job_id":"job_4a2e...","rating":5,"props":["On time","Clean","Fair price"]}'

Response

Field	Type	Description
review_id	string	Identifier for the created review.
status	string	Always recorded on success.
reversible_until	ISO date-time	The review can be withdrawn before this time. After that it is permanent.

Example response

{
  "review_id": "rev_2b9d...",
  "status": "recorded",
  "reversible_until": "2026-06-02T09:00:00Z"
}