---
title: Deals
description: A Deal is the immutable accepted terms.
canonical: https://breezewish.com/developers/concepts/deals
raw: https://breezewish.com/developers/concepts/deals.md
apiVersion: v1
lastUpdated: 2026-10-18
category: Concepts
---

# Deals

A Deal is the immutable snapshot of accepted terms. It is not the same event as verified closure.

## Resources

- `GET https://api.breezewish.com/v1/deals/{id}` scope `deals:read`
- `POST https://api.breezewish.com/v1/deals/{id}/approve` scope `deals:approve`, autonomy `COMMIT`. Humans also complete step-up.
- `POST https://api.breezewish.com/v1/deals/{id}/checkout` scope `deals:approve`, autonomy `COMMIT`
- MCP `get_deal`, `accept_offer`

Losing Offers are rejected because another Deal was accepted.

## Schema

[https://api.breezewish.com/schemas/v1/deal.json](https://api.breezewish.com/schemas/v1/deal.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. |
