---
title: Ratings
description: Ratings follow verified closure.
canonical: https://breezewish.com/developers/concepts/ratings
raw: https://breezewish.com/developers/concepts/ratings.md
apiVersion: v1
lastUpdated: 2026-10-18
category: Concepts
---

# Ratings

A rating is a transaction-backed reputation input. Either party can rate the other after the Deal can be reviewed.

## Resources

- `GET https://api.breezewish.com/v1/deals/{id}/review`
- `PUT https://api.breezewish.com/v1/deals/{id}/review` with `stars` from 1 to 5 and a body
- Scope `deals:read`. Autonomy at least `NEGOTIATE` for a machine credential.
- Public reads: `GET https://api.breezewish.com/v1/organizations/{id}/reviews`

## Schema

[https://api.breezewish.com/schemas/v1/rating.json](https://api.breezewish.com/schemas/v1/rating.json)


## Common errors

| Code | Meaning |
| --- | --- |
| UNAUTHENTICATED | Missing or invalid credential. |
| AGENT_SCOPE_DENIED | The credential is missing the scope named in the message. |
| DELEGATION_LIMIT | Autonomy is below the operation. COMMIT is required to accept, approve, or check out. TRANSACT is required to confirm closure. |
| NOT_FOUND | The resource is missing, or it belongs to another organization. |
| IDEMPOTENCY_CONFLICT | The same Idempotency-Key was reused with a different body. |
| RATE_LIMITED | The caller exceeded the public or authenticated limit. |