Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.
An OAuth access token for the buyer resource (audience, issuer and signature checked). Its scopes and the active grant the person approved are both enforced.
Headers
Idempotency-Key
string
required
Stable key for one logical write. 8–64 characters. Reusing it with different input returns 409.
fits: this exact Offer version matches the user's current intent as you understand it. needs_user: you must ask the user before deciding (for example a price above their stated limit, or a changed term). does_not_fit: it does not match; the Offer stops counting for this buyer.
Available options:
fits,
needs_user,
does_not_fit
reason_code
enum<string>
Optional main reason for needs_user or does_not_fit.
Available options:
price,
quantity,
product,
terms,
delivery,
timing,
seller,
other
note
string
Optional short private note for the user. Never include payment details.
Required string length: 1 - 280
Response
Private result; no-store/noindex. No payment or executable order is implied.
validation
object
required
Show child attributes
demand
object
required
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.
Show child attributes
execution_available
boolean
required
execution
object
Show child attributes
message
string
What to tell the person.
agent_line
string
What the agent does next.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Popular Demand","description":"Developer docs for buyers' agents: the Popular Demand MCP server, REST API and agent rules.","colors":{"primary":"#194e31","light":"#82dba0","dark":"#268951"},"logo":{"light":"https://mintcdn.com/popular-demand/g52KO83uh78kM1fM/logo/light.svg?fit=max\u0026auto=format\u0026n=g52KO83uh78kM1fM\u0026q=85\u0026s=52d88acb18e95d069daa5fd35ead78ad","dark":"https://mintcdn.com/popular-demand/g52KO83uh78kM1fM/logo/dark.svg?fit=max\u0026auto=format\u0026n=g52KO83uh78kM1fM\u0026q=85\u0026s=9297415a711e4a201255c80fcca898c2","href":"https://populardemand.market"},"favicon":"https://mintcdn.com/popular-demand/0Uv9-DJwl_bw6NRQ/favicon.svg?fit=max\u0026auto=format\u0026n=0Uv9-DJwl_bw6NRQ\u0026q=85\u0026s=a6476066c59b433dca3a348376788a69","background":{"color":{"light":"#f5f2ea","dark":"#161814"}},"navbar":{"links":[{"href":"https://populardemand.market","label":"Website"}],"primary":{"type":"button","label":"Connect","href":"https://populardemand.market/connect"}},"footer":{"socials":{"website":"https://populardemand.market"}},"seo":{"metatags":{"canonical":"https://docs.populardemand.market"}},"fonts":{"heading":{"family":"Geist"},"body":{"family":"Geist"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"popular-demand","hasAudioNarration":false,"actualSubdomain":"popular-demand","customDomains":["docs.populardemand.market"],"gitSource":{"type":"github","owner":"roic","repo":"condi","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":"","_id":"6afec04d8325b1d9eae75f9f"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0049bf41fcdaa6a1cc9126","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"REST API","count":19},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Requests","count":14},{"language":"default","tag":"MCP tools","count":10},{"language":"default","tag":"Notifications","count":10},{"language":"default","tag":"Tools","count":9},{"language":"default","tag":"Concepts","count":7},{"language":"default","tag":"Build","count":4},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"Offers","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"api-reference/offers/record-whether-an-offer-fits","slug":"/api-reference/offers/record-whether-an-offer-fits","pageMetadata":{"title":"Record whether an Offer fits","description":"Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/offers.json post /api/purchases/{id}/offers/{offerId}/validation","href":"/api-reference/offers/record-whether-an-offer-fits","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Record whether an Offer fits","description":"Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/offers.json post /api/purchases/{id}/offers/{offerId}/validation","href":"/api-reference/offers/record-whether-an-offer-fits","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/popular-demand/daae87efd33a508b/legacy-anchors.js"],"openApiReferenceData":{"operation":{"summary":"Record whether an Offer fits","tags":["Offers"],"operationId":"validateOffer","description":"Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.","security":["ad621238-6883-4c62-9fa3-d0f0b684275b"],"parameters":["dd9b98dc-8b62-48dc-ba71-cad0e3a5c788","f27ebad4-a9aa-42a7-9093-0fe91d978576","24f237c5-7d7b-43f1-9d40-e0f3ee4d4133","393c1fd1-664f-4005-a802-3e6061c1b5d5"],"requestBody":"95170931-a0fa-4333-8a61-13addc54ff7e","responses":{"200":"951b4fea-f493-4816-b510-506ea8713217","400":"4bc075ff-e474-4ce2-9f7e-0d88a0656bd0","401":"b8f02c8f-068e-46a4-a0fe-cb74b19f27f9","403":"870c17f8-ff85-4229-855e-19305a2d2ca8","404":"c395ce1a-8b4f-4dcf-bac1-57eabc769f66","409":"353016f2-46ae-4c5c-8c0c-f316052fe4bc","413":"9e5840e8-81de-44de-92f0-52c2c19b259a","429":"638d24f6-d1d0-4693-82ec-bcc668f9d561","500":"cb548b14-e609-4f28-ae55-f6dcb1120d95","503":"378fde78-af12-4705-95a0-771f869bdd1d"},"method":"post","type":"path","servers":["0536b972-6383-43de-b3c2-3b3947ce0bd3"],"path":"/api/purchases/{id}/offers/{offerId}/validation","baseUrlOptions":["https://populardemand.market"],"title":"Record whether an Offer fits","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dd9b98dc-8b62-48dc-ba71-cad0e3a5c788":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"f27ebad4-a9aa-42a7-9093-0fe91d978576":{"name":"offerId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"24f237c5-7d7b-43f1-9d40-e0f3ee4d4133":{"name":"Idempotency-Key","in":"header","required":true,"description":"Stable key for one logical write. 8–64 characters. Reusing it with different input returns 409.","schema":{"type":"string","minLength":8,"maxLength":64,"isRequired":true,"description":"Stable key for one logical write. 8–64 characters. Reusing it with different input returns 409.","uniqueKey":"","typeLabel":"string"}},"393c1fd1-664f-4005-a802-3e6061c1b5d5":{"name":"API-Version","in":"header","required":false,"description":"Current contract only; no version negotiation. See https://docs.populardemand.market/api-reference/introduction.","schema":{"type":"string","default":"2026-11-20","isRequired":false,"description":"Current contract only; no version negotiation. See https://docs.populardemand.market/api-reference/introduction.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_offer_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"expected_offer_version","typeLabel":"integer"},"expected_request_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"expected_request_version","typeLabel":"integer"},"verdict":{"type":"string","enum":["fits","needs_user","does_not_fit"],"description":"fits: this exact Offer version matches the user's current intent as you understand it. needs_user: you must ask the user before deciding (for example a price above their stated limit, or a changed term). does_not_fit: it does not match; the Offer stops counting for this buyer.","isRequired":true,"uniqueKey":"verdict","typeLabel":"enum\u003cstring>"},"reason_code":{"description":"Optional main reason for needs_user or does_not_fit.","type":"string","enum":["price","quantity","product","terms","delivery","timing","seller","other"],"uniqueKey":"reason_code","typeLabel":"enum\u003cstring>"},"note":{"description":"Optional short private note for the user. Never include payment details.","type":"string","minLength":1,"maxLength":280,"uniqueKey":"note","typeLabel":"string"}},"required":["expected_offer_version","expected_request_version","verdict"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"expected_offer_version":123,"expected_request_version":123,"note":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"951b4fea-f493-4816-b510-506ea8713217":{"description":"Private result; no-store/noindex. No payment or executable order is implied.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"validation":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"validation.id","typeLabel":"string\u003cuuid>"},"offer_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"validation.offer_id","typeLabel":"string\u003cuuid>"},"offer_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"validation.offer_version","typeLabel":"integer"},"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"validation.request_id","typeLabel":"string\u003cuuid>"},"request_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"validation.request_version","typeLabel":"integer"},"owner_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"validation.owner_id","typeLabel":"string\u003cuuid>"},"verdict":{"type":"string","enum":["fits","needs_user","does_not_fit"],"isRequired":true,"uniqueKey":"validation.verdict","typeLabel":"enum\u003cstring>"},"reason_code":{"oneOf":[{"type":"string","enum":["price","quantity","product","terms","delivery","timing","seller","other"],"isRequired":true,"uniqueKey":"validation.reason_code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"validation.reason_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"validation.reason_code","typeLabel":"enum\u003cstring> | null"},"note":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"validation.note.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"validation.note.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"validation.note","typeLabel":"string | null"},"transport":{"type":"string","enum":["web","api","agent","email_agent"],"isRequired":true,"uniqueKey":"validation.transport","typeLabel":"enum\u003cstring>"},"agent_client_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"validation.agent_client_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"validation.agent_client_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"validation.agent_client_id","typeLabel":"string | null"},"recorded_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","isRequired":true,"uniqueKey":"validation.recorded_at","typeLabel":"string\u003cdate-time>"}},"required":["id","offer_id","offer_version","request_id","request_version","owner_id","verdict","reason_code","note","transport","agent_client_id","recorded_at"],"additionalProperties":false,"isRequired":true,"uniqueKey":"validation","typeLabel":"object"},"demand":{"type":"object","properties":{"state":{"type":"string","enum":["not_counted","potential","validated","needs_user","committed"],"isRequired":true,"uniqueKey":"demand.state","typeLabel":"enum\u003cstring>"},"reasons":{"type":"array","items":{"type":"string","uniqueKey":"demand.reasons.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"demand.reasons","typeLabel":"string[]"},"price_qualified":{"type":"boolean","description":"Label only: the stated price policy qualifies this price. Not authorization.","isRequired":true,"uniqueKey":"demand.price_qualified","typeLabel":"boolean"},"price_position":{"oneOf":[{"type":"string","description":"Label only: the current all-in price against the Request’s ceilings. Null without a current evaluation. unknown means a limit exists but cannot be compared yet (see price_position_reason). above_limit Offers are still delivered.","enum":["no_limit","within_limit","above_limit","unknown"],"isRequired":true,"uniqueKey":"demand.price_position.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Label only: the current all-in price against the Request’s ceilings. Null without a current evaluation. unknown means a limit exists but cannot be compared yet (see price_position_reason). above_limit Offers are still delivered.","isRequired":true,"uniqueKey":"demand.price_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"demand.price_position","typeLabel":"enum\u003cstring> | null"},"above_limit_by_minor":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"demand.above_limit_by_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"demand.above_limit_by_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"demand.above_limit_by_minor","typeLabel":"integer | null"},"agent_reason_code":{"oneOf":[{"type":"string","enum":["price","quantity","product","terms","delivery","timing","seller","other"],"isRequired":true,"uniqueKey":"demand.agent_reason_code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"demand.agent_reason_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"demand.agent_reason_code","typeLabel":"enum\u003cstring> | null"},"validated_at":{"oneOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","isRequired":true,"uniqueKey":"demand.validated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"demand.validated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"demand.validated_at","typeLabel":"string\u003cdate-time> | null"},"hold":{"oneOf":[{"type":"object","required":["placed_at","simulated"],"properties":{"placed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","isRequired":true,"uniqueKey":"demand.hold.oneOf.0.placed_at","typeLabel":"string\u003cdate-time>"},"simulated":{"type":"boolean","isRequired":true,"uniqueKey":"demand.hold.oneOf.0.simulated","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"demand.hold.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"demand.hold.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"demand.hold","typeLabel":"object | null"},"payment_hold_available":{"type":"boolean","description":"Applies only to an Offer made while Popular Demand offered payment holds; otherwise false.","isRequired":true,"uniqueKey":"demand.payment_hold_available","typeLabel":"boolean"},"payment_hold_resumable":{"type":"boolean","description":"Applies only to an Offer made while Popular Demand offered payment holds; otherwise false.","isRequired":true,"uniqueKey":"demand.payment_hold_resumable","typeLabel":"boolean"},"payment_hold_opens_at":{"oneOf":[{"type":"string","description":"Applies only to an Offer made while Popular Demand offered payment holds; otherwise null.","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","isRequired":true,"uniqueKey":"demand.payment_hold_opens_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Applies only to an Offer made while Popular Demand offered payment holds; otherwise null.","isRequired":true,"uniqueKey":"demand.payment_hold_opens_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"demand.payment_hold_opens_at","typeLabel":"string\u003cdate-time> | null"},"payment_hold_reauthorization":{"oneOf":[{"type":"object","description":"Applies only to an Offer made while Popular Demand offered payment holds; otherwise null.","required":["offer_version","kind","reauthorize_by"],"properties":{"offer_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"demand.payment_hold_reauthorization.oneOf.0.offer_version","typeLabel":"integer"},"kind":{"type":"string","enum":["lapse","capture_refused"],"isRequired":true,"uniqueKey":"demand.payment_hold_reauthorization.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"reauthorize_by":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","isRequired":true,"uniqueKey":"demand.payment_hold_reauthorization.oneOf.0.reauthorize_by","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"demand.payment_hold_reauthorization.oneOf.0","typeLabel":"object"},{"type":"null","description":"Applies only to an Offer made while Popular Demand offered payment holds; otherwise null.","isRequired":true,"uniqueKey":"demand.payment_hold_reauthorization.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"demand.payment_hold_reauthorization","typeLabel":"object | null"},"price_position_reason":{"oneOf":[{"type":"string","description":"Why a limit cannot be compared yet: all_in_cost_unknown (some delivery, tax, duty or fee amount is missing), cost_scope_unknown (the seller did not split costs per item for a per-item all-in limit), currency_mismatch (a limit uses another currency) or variant_price_unknown (the store’s price for the size, colour or version the person chose is not known).","enum":["all_in_cost_unknown","cost_scope_unknown","currency_mismatch","variant_price_unknown"],"uniqueKey":"demand.price_position_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"demand.price_position_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"demand.price_position_reason","typeLabel":"enum\u003cstring> | null"},"request_committed_total_minor":{"description":"Applies only to an Offer made while Popular Demand offered payment holds; otherwise 0.","type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"demand.request_committed_total_minor","typeLabel":"integer"},"request_limit_minor":{"oneOf":[{"type":"integer","description":"Label only: the tightest whole-Request all-in limit (the root price or a basket all-in ceiling). Null when the person has not set one.","maximum":9007199254740991,"minimum":0,"exclusiveMinimum":true,"uniqueKey":"demand.request_limit_minor.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Label only: the tightest whole-Request all-in limit (the root price or a basket all-in ceiling). Null when the person has not set one.","uniqueKey":"demand.request_limit_minor.oneOf.1","typeLabel":"null"}],"uniqueKey":"demand.request_limit_minor","typeLabel":"integer | null"},"above_request_limit_by_minor":{"oneOf":[{"type":"integer","description":"Label only: how far the committed total exceeds the limit (0 when within it, null without a limit). Never a gate.","maximum":9007199254740991,"minimum":0,"uniqueKey":"demand.above_request_limit_by_minor.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Label only: how far the committed total exceeds the limit (0 when within it, null without a limit). Never a gate.","uniqueKey":"demand.above_request_limit_by_minor.oneOf.1","typeLabel":"null"}],"uniqueKey":"demand.above_request_limit_by_minor","typeLabel":"integer | null"},"request_total_with_offer_minor":{"oneOf":[{"type":"integer","description":"Label only: request_committed_total_minor plus this Offer's current all-in amount. Null when the all-in amount is unknown.","maximum":9007199254740991,"minimum":0,"uniqueKey":"demand.request_total_with_offer_minor.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Label only: request_committed_total_minor plus this Offer's current all-in amount. Null when the all-in amount is unknown.","uniqueKey":"demand.request_total_with_offer_minor.oneOf.1","typeLabel":"null"}],"uniqueKey":"demand.request_total_with_offer_minor","typeLabel":"integer | null"},"above_request_limit_with_offer_by_minor":{"oneOf":[{"type":"integer","description":"Label only: how far request_total_with_offer_minor would exceed the whole-Request limit (0 when within it, null without a limit or a known total). Never a gate.","maximum":9007199254740991,"minimum":0,"uniqueKey":"demand.above_request_limit_with_offer_by_minor.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Label only: how far request_total_with_offer_minor would exceed the whole-Request limit (0 when within it, null without a limit or a known total). Never a gate.","uniqueKey":"demand.above_request_limit_with_offer_by_minor.oneOf.1","typeLabel":"null"}],"uniqueKey":"demand.above_request_limit_with_offer_by_minor","typeLabel":"integer | null"}},"required":["state","reasons","price_qualified","price_position","above_limit_by_minor","agent_reason_code","validated_at","hold","payment_hold_available","payment_hold_resumable","payment_hold_opens_at","payment_hold_reauthorization"],"additionalProperties":false,"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.","isRequired":true,"uniqueKey":"demand","typeLabel":"object"},"execution_available":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"execution_available","typeLabel":"boolean"},"execution":{"type":"object","properties":{"mode":{"type":"string","enum":["authorization_hold","seller_price_guarantee"],"isRequired":true,"uniqueKey":"execution.mode","typeLabel":"enum\u003cstring>"},"money_backed":{"type":"boolean","description":"True only for authorization_hold, on an Offer made while Popular Demand offered payment holds; false for a group-price Offer, where no buyer money passes through Popular Demand.","isRequired":true,"uniqueKey":"execution.money_backed","typeLabel":"boolean"},"buyer_commits":{"type":"string","isRequired":true,"uniqueKey":"execution.buyer_commits","typeLabel":"string"},"checkout":{"type":"string","enum":["popular_demand","seller"],"isRequired":true,"uniqueKey":"execution.checkout","typeLabel":"enum\u003cstring>"},"terms_version":{"type":"string","enum":["c3_c5_v1","spg_v1","spg_v2"],"isRequired":true,"uniqueKey":"execution.terms_version","typeLabel":"enum\u003cstring>"},"deal":{"type":"object","properties":{"status":{"type":"string","enum":["open","ended"],"isRequired":true,"uniqueKey":"execution.deal.status","typeLabel":"enum\u003cstring>"},"ended_reason":{"oneOf":[{"type":"string","enum":["sold_out","date_passed"],"isRequired":true,"uniqueKey":"execution.deal.ended_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"execution.deal.ended_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"execution.deal.ended_reason","typeLabel":"enum\u003cstring> | null"},"available_until":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"execution.deal.available_until.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"execution.deal.available_until.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"execution.deal.available_until","typeLabel":"string | null"},"link":{"oneOf":[{"description":"This buyer’s own link to the seller’s deal page; give it only to the user. Popular Demand counts visits and, for a linked store, paid orders that used its codes.","type":"string","isRequired":true,"uniqueKey":"execution.deal.link.oneOf.0","typeLabel":"string"},{"description":"This buyer’s own link to the seller’s deal page; give it only to the user. Popular Demand counts visits and, for a linked store, paid orders that used its codes.","type":"null","isRequired":true,"uniqueKey":"execution.deal.link.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"execution.deal.link","typeLabel":"string | null"},"code":{"oneOf":[{"description":"What the buyer enters in the discount field at the seller’s checkout, if anything.","type":"string","isRequired":true,"uniqueKey":"execution.deal.code.oneOf.0","typeLabel":"string"},{"description":"What the buyer enters in the discount field at the seller’s checkout, if anything.","type":"null","isRequired":true,"uniqueKey":"execution.deal.code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"execution.deal.code","typeLabel":"string | null"},"link_shows_code":{"description":"Present when the link shows the buyer their own code to enter at the seller’s checkout, instead of opening the seller’s page.","type":"boolean","const":true,"uniqueKey":"execution.deal.link_shows_code","typeLabel":"boolean"},"units_left":{"description":"Present only when the price has a unit limit: the units still free now.","type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"execution.deal.units_left","typeLabel":"integer"}},"required":["status","ended_reason","available_until","link","code"],"additionalProperties":false,"uniqueKey":"execution.deal","typeLabel":"object"}},"required":["mode","money_backed","buyer_commits","checkout","terms_version"],"additionalProperties":false,"uniqueKey":"execution","typeLabel":"object"},"message":{"description":"What to tell the person.","type":"string","uniqueKey":"message","typeLabel":"string"},"agent_line":{"description":"What the agent does next.","type":"string","uniqueKey":"agent_line","typeLabel":"string"}},"required":["validation","demand","execution_available"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"validation":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","offer_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","offer_version":123,"request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","request_version":123,"owner_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","verdict":"fits","reason_code":"price","note":"\u003cstring>","transport":"web","agent_client_id":"\u003cstring>","recorded_at":"2023-11-07T05:31:56Z"},"demand":{"state":"not_counted","reasons":["\u003cstring>"],"price_qualified":true,"price_position":"no_limit","above_limit_by_minor":4503599627370495,"agent_reason_code":"price","validated_at":"2023-11-07T05:31:56Z","hold":{"placed_at":"2023-11-07T05:31:56Z","simulated":true},"payment_hold_available":true,"payment_hold_resumable":true,"payment_hold_opens_at":"2023-11-07T05:31:56Z","payment_hold_reauthorization":{"offer_version":123,"kind":"lapse","reauthorize_by":"2023-11-07T05:31:56Z"},"price_position_reason":"all_in_cost_unknown","request_committed_total_minor":4503599627370495,"request_limit_minor":4503599627370495,"above_request_limit_by_minor":4503599627370495,"request_total_with_offer_minor":4503599627370495,"above_request_limit_with_offer_by_minor":4503599627370495},"execution_available":false,"execution":{"mode":"authorization_hold","money_backed":true,"buyer_commits":"\u003cstring>","checkout":"popular_demand","terms_version":"c3_c5_v1","deal":{"status":"open","ended_reason":"sold_out","available_until":"\u003cstring>","link":"\u003cstring>","code":"\u003cstring>","link_shows_code":true,"units_left":4503599627370495}},"message":"\u003cstring>","agent_line":"\u003cstring>"}}},"exampleType":"generated"}},"headers":{"RateLimit":{"description":"Present when this REST request counted against a per-caller hourly quota: the allowance left after it and seconds until the window resets, e.g. \"write\";r=19;t=1200. One list member per quota counted.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Present with RateLimit: the quota counted, e.g. \"write\";q=20;w=3600. Quotas shared beyond the caller (every caller, one network or one OAuth client) are reported only when they refuse.","schema":{"type":"string"}},"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"exampleType":"generated"},"4bc075ff-e474-4ce2-9f7e-0d88a0656bd0":{"description":"Invalid input / confirmation needed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","const":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"},"errors":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":false,"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123,"hint":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"headers":{"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"exampleType":"generated"},"b8f02c8f-068e-46a4-a0fe-cb74b19f27f9":{"description":"Verified identity or approved OAuth grant required","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","const":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"},"errors":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":false,"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123,"hint":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"headers":{"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"exampleType":"generated"},"870c17f8-ff85-4229-855e-19305a2d2ca8":{"description":"forbidden: missing permission; origin_not_allowed: foreign browser origin at MCP","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","const":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"},"errors":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":false,"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123,"hint":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"headers":{"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"exampleType":"generated"},"c395ce1a-8b4f-4dcf-bac1-57eabc769f66":{"description":"Not accessible to this identity / capability","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","const":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"},"errors":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":false,"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123,"hint":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"headers":{"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"exampleType":"generated"},"353016f2-46ae-4c5c-8c0c-f316052fe4bc":{"description":"Version, lifecycle or idempotency conflict; read current state","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","const":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"},"errors":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":false,"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123,"hint":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"headers":{"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"exampleType":"generated"},"9e5840e8-81de-44de-92f0-52c2c19b259a":{"description":"Request body exceeds 32 KB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","const":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"},"errors":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":false,"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123,"hint":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"headers":{"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"exampleType":"generated"},"638d24f6-d1d0-4693-82ec-bcc668f9d561":{"description":"A rate or resource cap was reached. Timed quotas carry Retry-After, RateLimit and RateLimit-Policy; untimed resource caps carry no reset headers.","headers":{"Retry-After":{"description":"Present only for a timed quota refusal: seconds until the next attempt. Untimed resource caps do not carry this header.","schema":{"type":"integer"}},"RateLimit":{"description":"Present only when an actual limiter reports a timed quota refusal. Remaining quota and reset, e.g. \"write\";r=0;t=1200.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Present only for an actual timed quota. The quota refused, e.g. \"write\";q=20;w=3600.","schema":{"type":"string"}},"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","const":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"},"errors":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":false,"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123,"hint":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"cb548b14-e609-4f28-ae55-f6dcb1120d95":{"description":"Safe internal error; retry the same logical request key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","const":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"},"errors":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":false,"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123,"hint":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"headers":{"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"exampleType":"generated"},"378fde78-af12-4705-95a0-771f869bdd1d":{"description":"Required configuration unavailable, bounded transient database failure or a payment provider that did not execute the request. A transient response has explicit retry advice (retryable, retry_after_seconds) and a matching Retry-After header. Reuse the identical logical command and key.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","const":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"hint":{"type":"string","uniqueKey":"error.hint","typeLabel":"string"},"errors":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"}},"required":["path","message"],"additionalProperties":false,"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123,"hint":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>"}]}}}},"exampleType":"generated"}},"headers":{"API-Version":{"description":"The served contract version; request headers do not select a historical version.","schema":{"type":"string","const":"2026-11-20"}}},"exampleType":"generated"}},"security":{"ad621238-6883-4c62-9fa3-d0f0b684275b":{"OwnerBearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"An OAuth access token for the buyer resource (audience, issuer and signature checked). Its scopes and the active grant the person approved are both enforced.","scopes":[],"schemeName":"OwnerBearer"}}},"servers":{"0536b972-6383-43de-b3c2-3b3947ce0bd3":{"url":"https://populardemand.market"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"An OAuth access token for the buyer resource (audience, issuer and signature checked). Its scopes and the active grant the person approved are both enforced.","scopes":[],"schemeName":"OwnerBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An OAuth access token for the buyer resource (audience, issuer and signature checked). Its scopes and the active grant the person approved are both enforced.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OwnerBearer","name":"Authorization"}],"title":"OwnerBearer"}]},"originalFileLocation":"api-reference/openapi/offers.json"},"subdomain":"popular-demand","siteName":"Popular Demand","title":"Record whether an Offer fits - Popular Demand","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T13:23:17.715Z","originalFileLocation":"api-reference/offers/record-whether-an-offer-fits.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Popular Demand\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Record whether an Offer fits - Popular Demand\">\u003cmeta data-mint-head property=\"og:description\" content=\"Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Popular Demand\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://popular-demand.mintlify.site/_mintlify/api/og/v2?division=Offers\u0026amp;title=Record+whether+an+Offer+fits\u0026amp;description=Record+a+confirmed+pre-check+of+one+exact+owned+Offer+and+Request+version%3A+fits%2C+needs_user+or+does_not_fit.+Requires+a+stable+Idempotency-Key+and%2C+for+OAuth+ag\u0026amp;theme=f691b217e7815ac0b6a128d0\u0026amp;signature=3a395f75875bc89fc8b0189916675b1fe9f3100319a09a06b90b1b86887cf78f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Record whether an Offer fits - Popular Demand\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://popular-demand.mintlify.site/_mintlify/api/og/v2?division=Offers\u0026amp;title=Record+whether+an+Offer+fits\u0026amp;description=Record+a+confirmed+pre-check+of+one+exact+owned+Offer+and+Request+version%3A+fits%2C+needs_user+or+does_not_fit.+Requires+a+stable+Idempotency-Key+and%2C+for+OAuth+ag\u0026amp;theme=f691b217e7815ac0b6a128d0\u0026amp;signature=3a395f75875bc89fc8b0189916675b1fe9f3100319a09a06b90b1b86887cf78f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/popular-demand/JcWd0iA7kaYCTSQt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Popular Demand\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#194e31\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/offers/record-whether-an-offer-fits.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.populardemand.market/#organization\",\"name\":\"Popular Demand\",\"url\":\"https://docs.populardemand.market\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/popular-demand/g52KO83uh78kM1fM/logo/light.svg?fit=max\u0026auto=format\u0026n=g52KO83uh78kM1fM\u0026q=85\u0026s=52d88acb18e95d069daa5fd35ead78ad\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.populardemand.market#website\",\"name\":\"Popular Demand\",\"url\":\"https://docs.populardemand.market\",\"publisher\":{\"@id\":\"https://docs.populardemand.market/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits#webpage\",\"url\":\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits\",\"name\":\"Record whether an Offer fits\",\"description\":\"Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.\",\"dateModified\":\"2026-11-20T13:23:17.715Z\",\"isPartOf\":{\"@id\":\"https://docs.populardemand.market#website\"},\"breadcrumb\":{\"@id\":\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Offers\",\"item\":\"https://docs.populardemand.market/api-reference/offers/get-offers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Offers\",\"item\":\"https://docs.populardemand.market/api-reference/offers/get-offers\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Record whether an Offer fits\",\"item\":\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits#apireference\",\"headline\":\"Record whether an Offer fits\",\"name\":\"Record whether an Offer fits\",\"description\":\"Record a confirmed pre-check of one exact owned Offer and Request version: fits, needs_user or does_not_fit. Requires a stable Idempotency-Key and, for OAuth agents, offer_fit permission and this Request in scope. A conflict requires a fresh read and user reconciliation. This records intent only; it never accepts an Offer, orders or pays. Price limits never grant spending authority.\",\"url\":\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits\",\"mainEntityOfPage\":{\"@id\":\"https://docs.populardemand.market/api-reference/offers/record-whether-an-offer-fits#webpage\"},\"dateModified\":\"2026-11-20T13:23:17.715Z\",\"publisher\":{\"@id\":\"https://docs.populardemand.market/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.populardemand.market#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Popular Demand\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Popular Demand\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/offers/record-whether-an-offer-fits.md","siteName":"Popular Demand","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"MCP tools","pages":[{"title":"MCP tools","href":"/mcp/overview"}]},{"tab":"REST API","groups":[{"group":"Overview","pages":[{"title":"REST API","href":"/api-reference/introduction"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Limits","href":"/api-reference/limits"}]},{"group":"Requests","pages":[{"group":"Requests","pages":[{"title":"List Requests","deprecated":null,"version":null,"openapi":"/api-reference/openapi/requests.json get /api/purchases","href":"/api-reference/requests/list-requests"},{"title":"Save a Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi/requests.json post /api/purchases","href":"/api-reference/requests/save-a-request"},{"title":"Get a Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi/requests.json get /api/purchases/{id}","href":"/api-reference/requests/get-a-request"},{"title":"Change a Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi/requests.json patch /api/purchases/{id}","href":"/api-reference/requests/change-a-request"},{"title":"Close or ask to close a Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi/requests.json post /api/purchases/{id}/close","href":"/api-reference/requests/close-or-ask-to-close-a-request"},{"title":"Confirm the buyer still wants a Request","deprecated":null,"version":null,"openapi":"/api-reference/openapi/requests.json post /api/purchases/{id}/reaffirm","href":"/api-reference/requests/confirm-the-buyer-still-wants-a-request"},{"title":"Propose an exact product","deprecated":null,"version":null,"openapi":"/api-reference/openapi/requests.json post /api/purchases/{id}/resolution","href":"/api-reference/requests/propose-an-exact-product"}]}]},{"group":"Offers","pages":[{"group":"Offers","pages":[{"title":"Get Offers","description":"Read owned candidate Offers, original term snapshots and current evaluation. Requires owner read permission. The default lists five recent Offers; optional limit is 1–20, with a truncation flag, next_cursor and fresh read time. Continue with paired before_created_at/before_id; each page is an independent read. Optional offer_id reads one exact owned Offer for this Request and cannot be combined with a cursor. Private draft/status capabilities receive no Offers. Reading never reaffirms or accepts.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/offers.json get /api/purchases/{id}/offers","href":"/api-reference/offers/get-offers"},{"title":"Record whether an Offer fits","deprecated":null,"version":null,"openapi":"/api-reference/openapi/offers.json post /api/purchases/{id}/offers/{offerId}/validation","href":"/api-reference/offers/record-whether-an-offer-fits"}]}]},{"group":"Questions","pages":[{"group":"Questions","pages":[{"title":"Get questions","description":"Read up to 10 recent targeted questions for an owned Request from the last 30 days, newest first, with allowed typed answers, deadline, status and latest typed answer. Requires verified ownership; OAuth agents also need read permission and this Request in scope. Private capabilities are not accepted. Free-text replies and operator identity are never returned. Reading neither answers a question nor reaffirms interest. Answer with POST /api/purchases/{id}/answers.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/questions.json get /api/purchases/{id}/questions","href":"/api-reference/questions/get-questions"},{"title":"Answer a question","deprecated":null,"version":null,"openapi":"/api-reference/openapi/questions.json post /api/purchases/{id}/answers","href":"/api-reference/questions/answer-a-question"}]}]},{"group":"Notifications","pages":[{"group":"Notifications","pages":[{"title":"Get notification settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi/notifications.json get /api/notifications","href":"/api-reference/notifications/get-notification-settings"},{"title":"Change notification settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi/notifications.json patch /api/notifications","href":"/api-reference/notifications/change-notification-settings"},{"title":"Get demand-check settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi/notifications.json get /api/purchases/{id}/demand-checks","href":"/api-reference/notifications/get-demand-check-settings"},{"title":"Change demand-check settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi/notifications.json patch /api/purchases/{id}/demand-checks","href":"/api-reference/notifications/change-demand-check-settings"},{"title":"Set agent reachability","deprecated":null,"version":null,"openapi":"/api-reference/openapi/notifications.json post /api/purchases/{id}/reachability","href":"/api-reference/notifications/set-agent-reachability"}]}]}]}]},"basePath":"","title":"Record whether an Offer fits - Popular Demand","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}