> ## Documentation Index
> Fetch the complete documentation index at: https://docs.populardemand.market/llms.txt
> Use this file to discover all available pages before exploring further.

# respond_to_offer

> Respond to an Offer

Tell us whether an Offer fits what the person asked for. This does not buy, reserve or pay.

## Access

| Property | Value |
| - | - |
| OAuth scope | `purchases:write` |
| Effect | `reversible` |
| `readOnlyHint` | No |
| `destructiveHint` | Yes |
| `idempotentHint` | Yes |
| `openWorldHint` | No |

The buyer also approves each permission on the consent page. See [Authentication](https://docs.populardemand.market/authentication.md).

## Arguments

| Field | Type | Required | Description |
| - | - | - | - |
| `request_id` | string (uuid) | Yes | The Request’s id from list\_requests. |
| `offer_id` | string (uuid) | Yes | The Offer’s id from get\_offers. |
| `verdict` | `fits`, `does_not_fit` | Yes | fits: this Offer matches what the person asked for. does\_not\_fit: it doesn’t, and it stops counting for them. |
| `reason_code` | `price`, `quantity`, `product`, `terms`, `delivery`, `timing`, `seller`, `other` | No | Optional main reason for does\_not\_fit. |
| `note` | string | No | Optional short private note for the person. Never include payment details. |
| `expected_offer_version` | integer | No | The Offer version you last read. |
| `request_key` | string | No | Optional. The same key repeats a change safely; one is derived when left out. |

> [accordion] Input JSON Schema
>
> ```json theme={null}
> {
>   "type": "object",
>   "properties": {
>     "request_id": {
>       "type": "string",
>       "format": "uuid",
>       "description": "The Request’s id from list_requests."
>     },
>     "offer_id": {
>       "type": "string",
>       "format": "uuid",
>       "description": "The Offer’s id from get_offers."
>     },
>     "verdict": {
>       "type": "string",
>       "enum": [
>         "fits",
>         "does_not_fit"
>       ],
>       "description": "fits: this Offer matches what the person asked for. does_not_fit: it doesn’t, and it stops counting for them."
>     },
>     "reason_code": {
>       "type": "string",
>       "enum": [
>         "price",
>         "quantity",
>         "product",
>         "terms",
>         "delivery",
>         "timing",
>         "seller",
>         "other"
>       ],
>       "description": "Optional main reason for does_not_fit."
>     },
>     "note": {
>       "type": "string",
>       "minLength": 1,
>       "maxLength": 280,
>       "description": "Optional short private note for the person. Never include payment details."
>     },
>     "expected_offer_version": {
>       "type": "integer",
>       "exclusiveMinimum": 0,
>       "maximum": 9007199254740991,
>       "description": "The Offer version you last read."
>     },
>     "request_key": {
>       "description": "Optional. The same key repeats a change safely; one is derived when left out.",
>       "type": "string",
>       "minLength": 8,
>       "maxLength": 64
>     }
>   },
>   "required": [
>     "request_id",
>     "offer_id",
>     "verdict"
>   ],
>   "additionalProperties": false
> }
> ```

> [accordion] Output JSON Schema
>
> ```json theme={null}
> {
>   "type": "object",
>   "properties": {
>     "result": {
>       "type": "object",
>       "properties": {
>         "validation": {
>           "type": "object",
>           "additionalProperties": true
>         },
>         "demand": {
>           "type": "object",
>           "description": "Derived demand state: potential (fits the outcome), validated (the buyer agent's latest pre-check of this exact Offer version said fits), needs_user (the agent must ask the user), committed (an authorized card payment, only on an Offer made while Popular Demand offered payment holds). not_counted means no current claim, never a refusal unless reasons say the agent declined. Price position is a label, never a gate.",
>           "additionalProperties": true
>         },
>         "execution": {
>           "type": "object",
>           "additionalProperties": true
>         },
>         "execution_available": {
>           "type": "boolean",
>           "const": false
>         }
>       },
>       "required": [
>         "validation",
>         "demand",
>         "execution_available"
>       ],
>       "additionalProperties": false
>     }
>   },
>   "required": [
>     "result"
>   ],
>   "additionalProperties": false
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.