Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.
POST
/
api
/
purchases
Save a Request
curl --request POST \ --url https://populardemand.market/api/purchases \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: <idempotency-key>' \ --data '{ "request": { "words": "I might buy a Hobie Outback later. Find a meaningfully better deal.", "country": "US", "currency": "USD", "destination": { "city": "San Francisco", "scope": "regional" }, "time_horizon": "Before May; ask me which year", "source": "community:example-club" }}'
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.
While this is a draft an email agent sent: that agent's mailbox, which activation can make a delegate for this Request. Null otherwise.
offer_email
object
Show child attributes
possible_duplicate_of
object[]
Open Requests of the same owner that closely match this new one: the same exact product references, the same top Need option set or the same words, with an overlapping destination. The new Request was saved anyway. If one is for the same thing, ask the person which to keep, then update or close the other so they are counted once.
Maximum array length: 5
Show child attributes
duplicate_hint
string | null
save_confirmation
object
Show child attributes
needs_attention
enum<string>[]
Available options:
new_offer,
open_question,
details_needed,
still_want,
offer_ending
attention
object[]
Each needs_attention flag in words.
Show child attributes
next_step
string | null
The one next step, or null.
message
string
What to tell the person.
agent_line
string
What the agent does next.
open_questions
object[]
Questions to answer with POST /api/purchases/{id}/answers before their deadline.
Show child attributes
notifications
object
Show child attributes
supplier_text_is_untrusted
boolean
untrusted_text_fields
string[]
Maximum array length: 20
{"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/requests/save-a-request","slug":"/api-reference/requests/save-a-request","pageMetadata":{"title":"Save a Request","description":"Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/requests.json post /api/purchases","href":"/api-reference/requests/save-a-request","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: \"Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.\"\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":"Save a Request","description":"Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/requests.json post /api/purchases","href":"/api-reference/requests/save-a-request","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/popular-demand/daae87efd33a508b/legacy-anchors.js"],"openApiReferenceData":{"operation":{"summary":"Save a Request","tags":["Requests"],"operationId":"saveFuturePurchase","description":"Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.","security":["a23e9d3f-1374-4101-a7f8-89ab308f044d"],"parameters":["06e0a7ff-3328-405c-b9df-ace020c72192","bda2bbb3-f53b-46ce-a3e9-9ada6616df3d"],"requestBody":"282134b5-776c-4375-89b9-70866d697dc5","responses":{"201":"fda618df-c3c9-4818-a00f-9846eb1b7627","400":"6b910bc9-91b1-4307-9848-d8e9bc65109a","401":"eac64a5c-fa54-4c0b-9b94-077206063c9a","403":"71e016c5-a807-4e21-aab3-14391669722c","404":"28a90e20-84fd-4703-8f4d-b7f99262625b","409":"45bf7741-3433-4937-9b94-1a99ff02c9b4","413":"cd62497e-9f3b-4798-a732-82aae0908750","429":"7e4d64cb-df26-410d-ac7f-7234faa0a882","500":"3c84ab10-5401-412c-bcfc-d962421826f4","503":"eaf08e15-8f38-4260-b111-822e8c335cd8"},"method":"post","type":"path","servers":["e56e4a12-28aa-435a-b75d-84640adc9857"],"path":"/api/purchases","baseUrlOptions":["https://populardemand.market"],"title":"Save a Request","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"06e0a7ff-3328-405c-b9df-ace020c72192":{"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"}},"bda2bbb3-f53b-46ce-a3e9-9ada6616df3d":{"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":{"request":{"type":"object","properties":{"words":{"type":"string","minLength":5,"maxLength":4000,"description":"What the person asked for, in their own words and language.","isRequired":true,"uniqueKey":"request.words","typeLabel":"string"},"country":{"default":"US","type":"string","pattern":"^[A-Z]{2}$","enum":["US","IL"],"uniqueKey":"request.country","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","enum":["USD","ILS"],"uniqueKey":"request.currency","typeLabel":"enum\u003cstring>"},"destination":{"default":{},"type":"object","properties":{"postal_code":{"description":"A US ZIP (12345 or 12345-6789) or a 7-digit Israeli postal code. Optional when saving; required before an Offer can be prepared.","type":"string","maxLength":32,"uniqueKey":"request.destination.postal_code","typeLabel":"string"},"city":{"type":"string","minLength":1,"maxLength":100,"uniqueKey":"request.destination.city","typeLabel":"string"},"region":{"description":"State or region; derived from postal_code when one is given.","type":"string","minLength":1,"maxLength":100,"uniqueKey":"request.destination.region","typeLabel":"string"},"scope":{"type":"string","enum":["national_parcel","regional","unknown"],"uniqueKey":"request.destination.scope","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"request.destination","typeLabel":"object"},"need_by":{"oneOf":[{"type":"string","format":"date","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])))$","uniqueKey":"request.need_by.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","uniqueKey":"request.need_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"request.need_by","typeLabel":"string\u003cdate> | null"},"time_horizon":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"request.time_horizon","typeLabel":"string"},"delivery":{"maxItems":2,"type":"array","items":{"type":"string","enum":["shipping","pickup"],"uniqueKey":"request.delivery.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"request.delivery","typeLabel":"enum\u003cstring>[]"},"all_items_required":{"type":"boolean","uniqueKey":"request.all_items_required","typeLabel":"boolean"},"items":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"description":{"type":"string","minLength":3,"maxLength":1000,"isRequired":true,"uniqueKey":"request.\\items.items.[INDEX].description","typeLabel":"string"},"item_id":{"description":"Optional stable id; one is assigned when left out.","type":"string","pattern":"^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$","uniqueKey":"request.\\items.items.[INDEX].item_id","typeLabel":"string"},"quantity":{"oneOf":[{"type":"integer","description":"How many; null when the person hasn’t said.","maximum":10000,"minimum":1,"uniqueKey":"request.\\items.items.[INDEX].quantity.oneOf.0","typeLabel":"integer"},{"type":"null","description":"How many; null when the person hasn’t said.","uniqueKey":"request.\\items.items.[INDEX].quantity.oneOf.1","typeLabel":"null"}],"uniqueKey":"request.\\items.items.[INDEX].quantity","typeLabel":"integer | null"},"required":{"description":"Leave out unless the person says this item is optional. Optional items don’t count in the pool counts people see.","type":"boolean","uniqueKey":"request.\\items.items.[INDEX].required","typeLabel":"boolean"},"options":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"description":{"type":"string","minLength":3,"maxLength":500,"isRequired":true,"uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].description","typeLabel":"string"},"option_id":{"description":"Keep an existing option’s id; leave out for a new one.","type":"string","pattern":"^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$","uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].option_id","typeLabel":"string"},"product":{"type":"object","properties":{"brand":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].product.brand","typeLabel":"string"},"model":{"type":"string","minLength":1,"maxLength":200,"uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].product.model","typeLabel":"string"},"url":{"type":"string","maxLength":2000,"format":"uri","uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].product.url","typeLabel":"string\u003curi>"},"attributes":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"isRequired":true,"uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].product.attributes.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","minLength":1,"maxLength":100,"isRequired":true,"uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].product.attributes.items.[INDEX].value","typeLabel":"string"}},"required":["name","value"],"additionalProperties":false,"uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].product.attributes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].product.attributes","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX].product","typeLabel":"object"}},"required":["description"],"additionalProperties":false,"uniqueKey":"request.\\items.items.[INDEX].options.items.[INDEX]","typeLabel":"object"},"description":"The models the person would accept: several options mean any one of them, not several purchases.","uniqueKey":"request.\\items.items.[INDEX].options","typeLabel":"object[]"},"terms":{"type":"object","properties":{"warranty_months_min":{"oneOf":[{"type":"integer","maximum":120,"minimum":0,"uniqueKey":"request.\\items.items.[INDEX].terms.warranty_months_min.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"request.\\items.items.[INDEX].terms.warranty_months_min.oneOf.1","typeLabel":"null"}],"uniqueKey":"request.\\items.items.[INDEX].terms.warranty_months_min","typeLabel":"integer | null"},"returns_days_min":{"oneOf":[{"type":"integer","maximum":365,"minimum":0,"uniqueKey":"request.\\items.items.[INDEX].terms.returns_days_min.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"request.\\items.items.[INDEX].terms.returns_days_min.oneOf.1","typeLabel":"null"}],"uniqueKey":"request.\\items.items.[INDEX].terms.returns_days_min","typeLabel":"integer | null"},"authorized_seller_required":{"oneOf":[{"type":"boolean","uniqueKey":"request.\\items.items.[INDEX].terms.authorized_seller_required.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"request.\\items.items.[INDEX].terms.authorized_seller_required.oneOf.1","typeLabel":"null"}],"uniqueKey":"request.\\items.items.[INDEX].terms.authorized_seller_required","typeLabel":"boolean | null"}},"additionalProperties":false,"uniqueKey":"request.\\items.items.[INDEX].terms","typeLabel":"object"},"price_limit":{"type":"object","properties":{"amount_minor":{"type":"integer","exclusiveMinimum":0,"maximum":100000000,"isRequired":true,"uniqueKey":"request.\\items.items.[INDEX].price_limit.amount_minor","typeLabel":"integer"},"includes_delivery_and_tax":{"type":"boolean","isRequired":true,"uniqueKey":"request.\\items.items.[INDEX].price_limit.includes_delivery_and_tax","typeLabel":"boolean"}},"required":["amount_minor","includes_delivery_and_tax"],"additionalProperties":false,"description":"The most the person will pay for one unit of this item, in the currency’s smallest unit. Record it only when the person volunteers it. For a limit on the whole order, use the Request’s price_limit.","uniqueKey":"request.\\items.items.[INDEX].price_limit","typeLabel":"object"}},"required":["description"],"additionalProperties":false,"description":"One item the person needs, with how many if known. Its options are the models they would accept: several options mean any one of them, not several purchases.","uniqueKey":"request.\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"request.\\items","typeLabel":"object[]"},"price_limit":{"type":"object","properties":{"amount_minor":{"type":"integer","exclusiveMinimum":0,"maximum":100000000,"isRequired":true,"uniqueKey":"request.price_limit.amount_minor","typeLabel":"integer"},"includes_delivery_and_tax":{"type":"boolean","isRequired":true,"uniqueKey":"request.price_limit.includes_delivery_and_tax","typeLabel":"boolean"}},"required":["amount_minor","includes_delivery_and_tax"],"additionalProperties":false,"description":"The most the person will pay for the whole order, in the currency’s smallest unit (cents for USD). Record it only when the person volunteers it; never ask for one. It marks Offers above it and is not permission to spend.","uniqueKey":"request.price_limit","typeLabel":"object"},"source":{"type":"string","pattern":"^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,99}$","uniqueKey":"request.source","typeLabel":"string"},"expires_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)))$","uniqueKey":"request.expires_at","typeLabel":"string\u003cdate-time>"}},"required":["words"],"additionalProperties":false,"isRequired":true,"uniqueKey":"request","typeLabel":"object"}},"required":["request"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"illustrative":{"title":"illustrative","summary":"Illustrative input: replace request, source, IDs and versions; never submit as real demand.","value":{"request":{"words":"I might buy a Hobie Outback later. Find a meaningfully better deal.","country":"US","currency":"USD","destination":{"city":"San Francisco","scope":"regional"},"time_horizon":"Before May; ask me which year","source":"community:example-club"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"fda618df-c3c9-4818-a00f-9846eb1b7627":{"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":{"blockers":{"type":"array","items":{"type":"string","uniqueKey":"blockers.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"blockers","typeLabel":"string[]"},"next_actions":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"next_actions.items.[INDEX].code","typeLabel":"string"},"actor":{"type":"string","isRequired":true,"uniqueKey":"next_actions.items.[INDEX].actor","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"next_actions.items.[INDEX].message","typeLabel":"string"}},"required":["code","actor","message"],"additionalProperties":false,"uniqueKey":"next_actions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"next_actions","typeLabel":"object[]"},"as_of":{"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":"as_of","typeLabel":"string\u003cdate-time>"},"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":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["draft","active","closed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"version","typeLabel":"integer"},"original_raw_request":{"type":"string","isRequired":true,"uniqueKey":"original_raw_request","typeLabel":"string"},"raw_request":{"type":"string","isRequired":true,"uniqueKey":"raw_request","typeLabel":"string"},"country":{"type":"string","pattern":"^[A-Z]{2}$","enum":["US","IL"],"isRequired":true,"uniqueKey":"country","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","enum":["USD","ILS"],"isRequired":true,"uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"destination":{"type":"object","properties":{"scope":{"default":"unknown","type":"string","enum":["national_parcel","regional","unknown"],"isRequired":true,"uniqueKey":"destination.scope","typeLabel":"enum\u003cstring>"},"city":{"type":"string","minLength":1,"maxLength":100,"uniqueKey":"destination.city","typeLabel":"string"},"region":{"type":"string","minLength":1,"maxLength":100,"uniqueKey":"destination.region","typeLabel":"string"},"zip":{"type":"string","pattern":"^[a-zA-Z0-9 -]{3,12}$","uniqueKey":"destination.zip","typeLabel":"string"},"postal_code":{"type":"string","maxLength":32,"uniqueKey":"destination.postal_code","typeLabel":"string"}},"required":["scope"],"additionalProperties":false,"isRequired":true,"uniqueKey":"destination","typeLabel":"object"},"time_horizon":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"time_horizon.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"time_horizon.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"time_horizon","typeLabel":"string | null"},"need_by":{"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":"need_by.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"need_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"need_by","typeLabel":"string\u003cdate-time> | null"},"items":{"type":"array","items":{"type":"object","properties":{"item_id":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].item_id","typeLabel":"string"},"description":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].description","typeLabel":"string"},"quantity":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].quantity.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"\\items.items.[INDEX].quantity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].quantity","typeLabel":"integer | null"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"\\items.items.[INDEX].required","typeLabel":"boolean"},"confirmed":{"type":"boolean","isRequired":true,"uniqueKey":"\\items.items.[INDEX].confirmed","typeLabel":"boolean"},"options":{"type":"array","items":{"type":"object","properties":{"option_id":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].option_id","typeLabel":"string"},"description":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].description","typeLabel":"string"},"product":{"oneOf":[{"type":"object","required":["namespace","item_id"],"properties":{"namespace":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].product.oneOf.0.namespace","typeLabel":"string"},"item_id":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].product.oneOf.0.item_id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].product.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].product.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].product","typeLabel":"object | null"},"attributes":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].attributes.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","minLength":1,"maxLength":100,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].attributes.items.[INDEX].value","typeLabel":"string"}},"required":["name","value"],"additionalProperties":false,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].attributes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].attributes","typeLabel":"object[]"},"url":{"type":"string","format":"uri","uniqueKey":"\\items.items.[INDEX].options.items.[INDEX].url","typeLabel":"string\u003curi>"}},"required":["option_id","description","product"],"additionalProperties":false,"uniqueKey":"\\items.items.[INDEX].options.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"\\items.items.[INDEX].options","typeLabel":"object[]"},"terms":{"type":"object","properties":{"warranty_months_min":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms.warranty_months_min.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms.warranty_months_min.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms.warranty_months_min","typeLabel":"integer | null"},"returns_days_min":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms.returns_days_min.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms.returns_days_min.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms.returns_days_min","typeLabel":"integer | null"},"authorized_seller_required":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms.authorized_seller_required.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms.authorized_seller_required.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms.authorized_seller_required","typeLabel":"boolean | null"}},"required":["warranty_months_min","returns_days_min","authorized_seller_required"],"additionalProperties":false,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].terms","typeLabel":"object"}},"required":["item_id","description","quantity","required","confirmed","options","terms"],"additionalProperties":false,"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"price_limits":{"type":"array","items":{"type":"object","properties":{"limit_id":{"type":"string","isRequired":true,"uniqueKey":"price_limits.items.[INDEX].limit_id","typeLabel":"string"},"item_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"price_limits.items.[INDEX].item_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"price_limits.items.[INDEX].item_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"price_limits.items.[INDEX].item_id","typeLabel":"string | null"},"includes_delivery_and_tax":{"type":"boolean","isRequired":true,"uniqueKey":"price_limits.items.[INDEX].includes_delivery_and_tax","typeLabel":"boolean"},"amount_minor":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"price_limits.items.[INDEX].amount_minor","typeLabel":"integer"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","enum":["USD","ILS"],"isRequired":true,"uniqueKey":"price_limits.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"set_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":"price_limits.items.[INDEX].set_at","typeLabel":"string\u003cdate-time>"}},"required":["limit_id","item_id","includes_delivery_and_tax","amount_minor","currency","set_at"],"additionalProperties":false,"uniqueKey":"price_limits.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"price_limits","typeLabel":"object[]"},"delivery":{"type":"array","items":{"type":"string","enum":["shipping","pickup"],"uniqueKey":"delivery.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"delivery","typeLabel":"enum\u003cstring>[]"},"all_items_required":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"all_items_required.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"all_items_required.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"all_items_required","typeLabel":"boolean | null"},"resolution_status":{"type":"string","enum":["unresolved","proposed","resolved"],"isRequired":true,"uniqueKey":"resolution_status","typeLabel":"enum\u003cstring>"},"research_status":{"type":"string","enum":["needs_research","provisional","reviewed"],"isRequired":true,"uniqueKey":"research_status","typeLabel":"enum\u003cstring>"},"source":{"type":"string","isRequired":true,"uniqueKey":"source","typeLabel":"string"},"created_via":{"type":"string","enum":["web","api","agent","email"],"isRequired":true,"uniqueKey":"created_via","typeLabel":"enum\u003cstring>"},"origin_client_id":{"oneOf":[{"type":"string","maxLength":2048,"isRequired":true,"uniqueKey":"origin_client_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"origin_client_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"origin_client_id","typeLabel":"string | null"},"created_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":"created_at","typeLabel":"string\u003cdate-time>"},"updated_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":"updated_at","typeLabel":"string\u003cdate-time>"},"expires_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":"expires_at","typeLabel":"string\u003cdate-time>"},"activated_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":"activated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"activated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"activated_at","typeLabel":"string\u003cdate-time> | null"},"last_reaffirmed_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":"last_reaffirmed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"last_reaffirmed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"last_reaffirmed_at","typeLabel":"string\u003cdate-time> | null"},"closed_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":"closed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"closed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"closed_at","typeLabel":"string\u003cdate-time> | null"},"closed_reason":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"closed_reason.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"closed_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"closed_reason","typeLabel":"string | null"},"observations":{"type":"array","items":{"type":"object","properties":{"outcome_description":{"type":"string","minLength":3,"maxLength":500,"isRequired":true,"uniqueKey":"observations.items.[INDEX].outcome_description","typeLabel":"string"},"item_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"observations.items.[INDEX].item_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"observations.items.[INDEX].item_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"observations.items.[INDEX].item_minor","typeLabel":"integer | null"},"shipping_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"isRequired":true,"uniqueKey":"observations.items.[INDEX].shipping_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"observations.items.[INDEX].shipping_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"observations.items.[INDEX].shipping_minor","typeLabel":"integer | null"},"tax_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"isRequired":true,"uniqueKey":"observations.items.[INDEX].tax_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"observations.items.[INDEX].tax_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"observations.items.[INDEX].tax_minor","typeLabel":"integer | null"},"duties_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"isRequired":true,"uniqueKey":"observations.items.[INDEX].duties_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"observations.items.[INDEX].duties_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"observations.items.[INDEX].duties_minor","typeLabel":"integer | null"},"total_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"observations.items.[INDEX].total_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"observations.items.[INDEX].total_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"observations.items.[INDEX].total_minor","typeLabel":"integer | null"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","enum":["USD","ILS"],"isRequired":true,"uniqueKey":"observations.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"source_url":{"type":"string","maxLength":2000,"format":"uri","isRequired":true,"uniqueKey":"observations.items.[INDEX].source_url","typeLabel":"string\u003curi>"},"seller_name":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"observations.items.[INDEX].seller_name","typeLabel":"string"},"observed_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":"observations.items.[INDEX].observed_at","typeLabel":"string\u003cdate-time>"},"valid_until":{"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":"observations.items.[INDEX].valid_until","typeLabel":"string\u003cdate-time>"},"availability":{"type":"string","enum":["available","unavailable","unknown"],"isRequired":true,"uniqueKey":"observations.items.[INDEX].availability","typeLabel":"enum\u003cstring>"},"terms":{"type":"object","properties":{"warranty":{"type":"string","maxLength":2000,"isRequired":true,"uniqueKey":"observations.items.[INDEX].terms.warranty","typeLabel":"string"},"returns":{"type":"string","maxLength":2000,"isRequired":true,"uniqueKey":"observations.items.[INDEX].terms.returns","typeLabel":"string"},"delivery":{"type":"string","maxLength":2000,"isRequired":true,"uniqueKey":"observations.items.[INDEX].terms.delivery","typeLabel":"string"},"legitimacy":{"type":"string","maxLength":2000,"isRequired":true,"uniqueKey":"observations.items.[INDEX].terms.legitimacy","typeLabel":"string"},"comparable":{"default":false,"type":"boolean","isRequired":true,"uniqueKey":"observations.items.[INDEX].terms.comparable","typeLabel":"boolean"},"all_in_confirmed":{"default":false,"type":"boolean","isRequired":true,"uniqueKey":"observations.items.[INDEX].terms.all_in_confirmed","typeLabel":"boolean"}},"required":["warranty","returns","delivery","legitimacy","comparable","all_in_confirmed"],"additionalProperties":false,"isRequired":true,"uniqueKey":"observations.items.[INDEX].terms","typeLabel":"object"},"confidence_note":{"type":"string","minLength":10,"maxLength":2000,"isRequired":true,"uniqueKey":"observations.items.[INDEX].confidence_note","typeLabel":"string"},"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":"observations.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"review_status":{"type":"string","enum":["provisional","verified","rejected"],"isRequired":true,"uniqueKey":"observations.items.[INDEX].review_status","typeLabel":"enum\u003cstring>"}},"required":["outcome_description","item_minor","shipping_minor","tax_minor","duties_minor","total_minor","currency","source_url","seller_name","observed_at","valid_until","availability","terms","confidence_note","id","review_status"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"observations.items.[INDEX].additionalProperties","typeLabel":"any"},"uniqueKey":"observations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"observations","typeLabel":"object[]"},"baseline":{"oneOf":[{"type":"object","required":["outcome_description","item_minor","shipping_minor","tax_minor","duties_minor","total_minor","currency","source_url","seller_name","observed_at","valid_until","availability","terms","confidence_note","id","review_status"],"properties":{"outcome_description":{"type":"string","minLength":3,"maxLength":500,"isRequired":true,"uniqueKey":"baseline.oneOf.0.outcome_description","typeLabel":"string"},"item_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"baseline.oneOf.0.item_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"baseline.oneOf.0.item_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"baseline.oneOf.0.item_minor","typeLabel":"integer | null"},"shipping_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"isRequired":true,"uniqueKey":"baseline.oneOf.0.shipping_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"baseline.oneOf.0.shipping_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"baseline.oneOf.0.shipping_minor","typeLabel":"integer | null"},"tax_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"isRequired":true,"uniqueKey":"baseline.oneOf.0.tax_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"baseline.oneOf.0.tax_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"baseline.oneOf.0.tax_minor","typeLabel":"integer | null"},"duties_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"isRequired":true,"uniqueKey":"baseline.oneOf.0.duties_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"baseline.oneOf.0.duties_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"baseline.oneOf.0.duties_minor","typeLabel":"integer | null"},"total_minor":{"oneOf":[{"type":"integer","maximum":100000000,"minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"baseline.oneOf.0.total_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"baseline.oneOf.0.total_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"baseline.oneOf.0.total_minor","typeLabel":"integer | null"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","enum":["USD","ILS"],"isRequired":true,"uniqueKey":"baseline.oneOf.0.currency","typeLabel":"enum\u003cstring>"},"source_url":{"type":"string","maxLength":2000,"format":"uri","isRequired":true,"uniqueKey":"baseline.oneOf.0.source_url","typeLabel":"string\u003curi>"},"seller_name":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"baseline.oneOf.0.seller_name","typeLabel":"string"},"observed_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":"baseline.oneOf.0.observed_at","typeLabel":"string\u003cdate-time>"},"valid_until":{"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":"baseline.oneOf.0.valid_until","typeLabel":"string\u003cdate-time>"},"availability":{"type":"string","enum":["available","unavailable","unknown"],"isRequired":true,"uniqueKey":"baseline.oneOf.0.availability","typeLabel":"enum\u003cstring>"},"terms":{"type":"object","properties":{"warranty":{"type":"string","maxLength":2000,"isRequired":true,"uniqueKey":"baseline.oneOf.0.terms.warranty","typeLabel":"string"},"returns":{"type":"string","maxLength":2000,"isRequired":true,"uniqueKey":"baseline.oneOf.0.terms.returns","typeLabel":"string"},"delivery":{"type":"string","maxLength":2000,"isRequired":true,"uniqueKey":"baseline.oneOf.0.terms.delivery","typeLabel":"string"},"legitimacy":{"type":"string","maxLength":2000,"isRequired":true,"uniqueKey":"baseline.oneOf.0.terms.legitimacy","typeLabel":"string"},"comparable":{"default":false,"type":"boolean","isRequired":true,"uniqueKey":"baseline.oneOf.0.terms.comparable","typeLabel":"boolean"},"all_in_confirmed":{"default":false,"type":"boolean","isRequired":true,"uniqueKey":"baseline.oneOf.0.terms.all_in_confirmed","typeLabel":"boolean"}},"required":["warranty","returns","delivery","legitimacy","comparable","all_in_confirmed"],"additionalProperties":false,"isRequired":true,"uniqueKey":"baseline.oneOf.0.terms","typeLabel":"object"},"confidence_note":{"type":"string","minLength":10,"maxLength":2000,"isRequired":true,"uniqueKey":"baseline.oneOf.0.confidence_note","typeLabel":"string"},"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":"baseline.oneOf.0.id","typeLabel":"string\u003cuuid>"},"review_status":{"type":"string","enum":["provisional","verified","rejected"],"isRequired":true,"uniqueKey":"baseline.oneOf.0.review_status","typeLabel":"enum\u003cstring>"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"baseline.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"baseline.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"baseline.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"baseline","typeLabel":"object | null"},"pricing":{"type":"object","properties":{"status":{"type":"string","enum":["exploratory","price_specified"],"isRequired":true,"uniqueKey":"pricing.status","typeLabel":"enum\u003cstring>"},"amount_minor":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"pricing.amount_minor.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"pricing.amount_minor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"pricing.amount_minor","typeLabel":"integer | null"},"label":{"type":"string","uniqueKey":"pricing.label","typeLabel":"string"}},"required":["status","amount_minor"],"additionalProperties":false,"isRequired":true,"uniqueKey":"pricing","typeLabel":"object"},"baseline_diagnostics":{"type":"object","properties":{"status":{"type":"string","enum":["usable","missing","blocked"],"isRequired":true,"uniqueKey":"baseline_diagnostics.status","typeLabel":"enum\u003cstring>"},"checked_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":"baseline_diagnostics.checked_at","typeLabel":"string\u003cdate-time>"},"baseline_id":{"oneOf":[{"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":"baseline_diagnostics.baseline_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","isRequired":true,"uniqueKey":"baseline_diagnostics.baseline_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"baseline_diagnostics.baseline_id","typeLabel":"string\u003cuuid> | null"},"reason_codes":{"type":"array","items":{"type":"string","enum":["context_changed","future_observation","superseded","needs_review","rejected","not_comparable","incomplete_total","unavailable","availability_unknown","expired"],"uniqueKey":"baseline_diagnostics.reason_codes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"baseline_diagnostics.reason_codes","typeLabel":"enum\u003cstring>[]"},"observations":{"type":"array","items":{"type":"object","properties":{"observation_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":"baseline_diagnostics.observations.items.[INDEX].observation_id","typeLabel":"string\u003cuuid>"},"eligible":{"type":"boolean","isRequired":true,"uniqueKey":"baseline_diagnostics.observations.items.[INDEX].eligible","typeLabel":"boolean"},"reasons":{"type":"array","items":{"type":"string","enum":["context_changed","future_observation","superseded","needs_review","rejected","not_comparable","incomplete_total","unavailable","availability_unknown","expired"],"uniqueKey":"baseline_diagnostics.observations.items.[INDEX].reasons.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"baseline_diagnostics.observations.items.[INDEX].reasons","typeLabel":"enum\u003cstring>[]"}},"required":["observation_id","eligible","reasons"],"additionalProperties":false,"uniqueKey":"baseline_diagnostics.observations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"baseline_diagnostics.observations","typeLabel":"object[]"},"history_limit_reached":{"type":"boolean","isRequired":true,"uniqueKey":"baseline_diagnostics.history_limit_reached","typeLabel":"boolean"}},"required":["status","checked_at","baseline_id","reason_codes","observations","history_limit_reached"],"additionalProperties":false,"isRequired":true,"uniqueKey":"baseline_diagnostics","typeLabel":"object"},"execution_available":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"execution_available","typeLabel":"boolean"},"execution_note":{"type":"string","isRequired":true,"uniqueKey":"execution_note","typeLabel":"string"},"reachability":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","poll"],"isRequired":true,"uniqueKey":"reachability.items.[INDEX].channel","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["active","revoked"],"isRequired":true,"uniqueKey":"reachability.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"verified_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":"reachability.items.[INDEX].verified_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"reachability.items.[INDEX].verified_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reachability.items.[INDEX].verified_at","typeLabel":"string\u003cdate-time> | null"},"expected_check_hours":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"isRequired":true,"uniqueKey":"reachability.items.[INDEX].expected_check_hours.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"reachability.items.[INDEX].expected_check_hours.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reachability.items.[INDEX].expected_check_hours","typeLabel":"integer | null"},"last_polled_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":"reachability.items.[INDEX].last_polled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"reachability.items.[INDEX].last_polled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reachability.items.[INDEX].last_polled_at","typeLabel":"string\u003cdate-time> | null"},"last_delivered_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":"reachability.items.[INDEX].last_delivered_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"reachability.items.[INDEX].last_delivered_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reachability.items.[INDEX].last_delivered_at","typeLabel":"string\u003cdate-time> | null"}},"required":["channel","status","verified_at","expected_check_hours","last_polled_at","last_delivered_at"],"additionalProperties":false,"uniqueKey":"reachability.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reachability","typeLabel":"object[]"},"agent_events":{"type":"array","items":{"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":"agent_events.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"event_name":{"type":"string","enum":["request.research_updated","request.plan_prepared","request.plan_context_changed","request.question_asked","request.payment_updated"],"isRequired":true,"uniqueKey":"agent_events.items.[INDEX].event_name","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["active","revoked"],"isRequired":true,"uniqueKey":"agent_events.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"expires_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":"agent_events.items.[INDEX].expires_at","typeLabel":"string\u003cdate-time>"},"last_delivered_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":"agent_events.items.[INDEX].last_delivered_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"agent_events.items.[INDEX].last_delivered_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"agent_events.items.[INDEX].last_delivered_at","typeLabel":"string\u003cdate-time> | null"}},"required":["id","event_name","status","expires_at","last_delivered_at"],"additionalProperties":false,"uniqueKey":"agent_events.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"agent_events","typeLabel":"object[]"},"polling_access":{"type":"array","items":{"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":"polling_access.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"expires_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":"polling_access.items.[INDEX].expires_at","typeLabel":"string\u003cdate-time>"},"last_polled_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":"polling_access.items.[INDEX].last_polled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","isRequired":true,"uniqueKey":"polling_access.items.[INDEX].last_polled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"polling_access.items.[INDEX].last_polled_at","typeLabel":"string\u003cdate-time> | null"}},"required":["id","expires_at","last_polled_at"],"additionalProperties":false,"uniqueKey":"polling_access.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"polling_access","typeLabel":"object[]"},"email_delivery":{"type":"string","enum":["local_inbox","configured","unconfigured"],"isRequired":true,"uniqueKey":"email_delivery","typeLabel":"enum\u003cstring>"},"history":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"history.items.[INDEX].type","typeLabel":"string"},"occurred_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":"history.items.[INDEX].occurred_at","typeLabel":"string\u003cdate-time>"},"payload":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"history.items.[INDEX].payload.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"history.items.[INDEX].payload","typeLabel":"object"}},"required":["type","occurred_at","payload"],"additionalProperties":false,"uniqueKey":"history.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"history","typeLabel":"object[]"},"compatible_demand":{"type":"array","items":{"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":"compatible_demand.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"title":{"type":"string","isRequired":true,"uniqueKey":"compatible_demand.items.[INDEX].title","typeLabel":"string"},"compatibility_rule":{"type":"string","isRequired":true,"uniqueKey":"compatible_demand.items.[INDEX].compatibility_rule","typeLabel":"string"},"geography_scope":{"type":"string","isRequired":true,"uniqueKey":"compatible_demand.items.[INDEX].geography_scope","typeLabel":"string"},"active_intents":{"type":"string","isRequired":true,"uniqueKey":"compatible_demand.items.[INDEX].active_intents","typeLabel":"string"},"count_kind":{"type":"string","const":"active_requests","isRequired":true,"uniqueKey":"compatible_demand.items.[INDEX].count_kind","typeLabel":"string"},"executable_units":{"type":"number","const":0,"isRequired":true,"uniqueKey":"compatible_demand.items.[INDEX].executable_units","typeLabel":"number"},"observed_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":"compatible_demand.items.[INDEX].observed_at","typeLabel":"string\u003cdate-time>"}},"required":["id","title","compatibility_rule","geography_scope","active_intents","count_kind","executable_units","observed_at"],"additionalProperties":false,"uniqueKey":"compatible_demand.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"compatible_demand","typeLabel":"object[]"},"buyer_status":{"type":"object","properties":{"state":{"type":"string","enum":["closed","ended","not_confirmed","paused","bought","offer_ready","details_needed","confirm_needed","asking_sellers","no_offer","offer_ended","gathering_interest"],"isRequired":true,"uniqueKey":"buyer_status.state","typeLabel":"enum\u003cstring>"},"label":{"type":"string","isRequired":true,"uniqueKey":"buyer_status.label","typeLabel":"string"},"message":{"oneOf":[{"description":"The line the person sees under the status, or null. It can have several lines (one per saved item, then a sentence), separated by newlines. Show it as given.","type":"string","isRequired":true,"uniqueKey":"buyer_status.message.oneOf.0","typeLabel":"string"},{"description":"The line the person sees under the status, or null. It can have several lines (one per saved item, then a sentence), separated by newlines. Show it as given.","type":"null","isRequired":true,"uniqueKey":"buyer_status.message.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"buyer_status.message","typeLabel":"string | null"},"matching_people":{"oneOf":[{"type":"integer","description":"With gathering_interest only: the largest of item_counts[].people (null when none is a number). Counts only, never who; no threshold is published. Null in other states.","maximum":9007199254740991,"minimum":0,"isRequired":true,"uniqueKey":"buyer_status.matching_people.oneOf.0","typeLabel":"integer"},{"type":"null","description":"With gathering_interest only: the largest of item_counts[].people (null when none is a number). Counts only, never who; no threshold is published. Null in other states.","isRequired":true,"uniqueKey":"buyer_status.matching_people.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"buyer_status.matching_people","typeLabel":"integer | null"},"details":{"description":"With details_needed only: item (the exact item, quantity or delivery method is missing) or pickup_only (it accepts only pickup, which is not arranged for now; add delivery, with the user’s say-so, to have it counted).","type":"string","enum":["item","pickup_only"],"uniqueKey":"buyer_status.details","typeLabel":"enum\u003cstring>"},"matching_confirmation_counts":{"oneOf":[{"type":"object","required":["person","agent","unknown"],"properties":{"person":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"buyer_status.matching_confirmation_counts.oneOf.0.person","typeLabel":"integer"},"agent":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"buyer_status.matching_confirmation_counts.oneOf.0.agent","typeLabel":"integer"},"unknown":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"buyer_status.matching_confirmation_counts.oneOf.0.unknown","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"buyer_status.matching_confirmation_counts.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"buyer_status.matching_confirmation_counts.oneOf.1","typeLabel":"null"}],"uniqueKey":"buyer_status.matching_confirmation_counts","typeLabel":"object | null"},"item_counts":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"need_id":{"type":"string","isRequired":true,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX].need_id","typeLabel":"string"},"label":{"type":"string","isRequired":true,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX].label","typeLabel":"string"},"products":{"type":"array","items":{"type":"object","properties":{"namespace":{"type":"string","isRequired":true,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX].products.items.[INDEX].namespace","typeLabel":"string"},"item_id":{"type":"string","isRequired":true,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX].products.items.[INDEX].item_id","typeLabel":"string"}},"required":["namespace","item_id"],"additionalProperties":false,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX].products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX].products","typeLabel":"object[]"},"people":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX].people.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX].people.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX].people","typeLabel":"integer | null"}},"required":["need_id","label","products","people"],"additionalProperties":false,"uniqueKey":"buyer_status.item_counts.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"With gathering_interest only: for each saved item, the people (this person included) for whom one seller could make a single offer of that exact product: it is among every counted person's accepted options, with the same market and a delivery one seller can serve. The largest such group per item; groups tied for largest each get an entry, except groups of the same people, which share one entry listing each product (any of them could be offered). Groups are never added together. people is null when the only group is people nearby for pickup and fewer than 5 others are nearby, none included (message then says so; exact small local counts are not shown, and an empty area reads like a sparse one). Counts only, never who. Null in other states.","uniqueKey":"buyer_status.item_counts.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"With gathering_interest only: for each saved item, the people (this person included) for whom one seller could make a single offer of that exact product: it is among every counted person's accepted options, with the same market and a delivery one seller can serve. The largest such group per item; groups tied for largest each get an entry, except groups of the same people, which share one entry listing each product (any of them could be offered). Groups are never added together. people is null when the only group is people nearby for pickup and fewer than 5 others are nearby, none included (message then says so; exact small local counts are not shown, and an empty area reads like a sparse one). Counts only, never who. Null in other states.","uniqueKey":"buyer_status.item_counts.oneOf.1","typeLabel":"null"}],"uniqueKey":"buyer_status.item_counts","typeLabel":"object[] | null"}},"required":["state","label","message","matching_people"],"additionalProperties":false,"uniqueKey":"buyer_status","typeLabel":"object"},"exact_item_confirmation":{"oneOf":[{"type":"object","required":["confirmed_by","confirmed_at","request_version"],"properties":{"confirmed_by":{"type":"string","enum":["person","agent"],"isRequired":true,"uniqueKey":"exact_item_confirmation.oneOf.0.confirmed_by","typeLabel":"enum\u003cstring>"},"confirmed_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":"exact_item_confirmation.oneOf.0.confirmed_at","typeLabel":"string\u003cdate-time>"},"request_version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"exact_item_confirmation.oneOf.0.request_version","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"exact_item_confirmation.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"exact_item_confirmation.oneOf.1","typeLabel":"null"}],"uniqueKey":"exact_item_confirmation","typeLabel":"object | null"},"draft_agent":{"oneOf":[{"description":"While this is a draft an email agent sent: that agent's mailbox, which activation can make a delegate for this Request. Null otherwise.","type":"string","uniqueKey":"draft_agent.oneOf.0","typeLabel":"string"},{"description":"While this is a draft an email agent sent: that agent's mailbox, which activation can make a delegate for this Request. Null otherwise.","type":"null","uniqueKey":"draft_agent.oneOf.1","typeLabel":"null"}],"uniqueKey":"draft_agent","typeLabel":"string | null"},"offer_email":{"type":"object","properties":{"request_enabled":{"type":"boolean","isRequired":true,"uniqueKey":"offer_email.request_enabled","typeLabel":"boolean"},"permitted":{"type":"boolean","isRequired":true,"uniqueKey":"offer_email.permitted","typeLabel":"boolean"},"questions_emailed":{"type":"boolean","description":"Whether questions about this Request are emailed to the user. False while email updates for it are off: tell the user they could miss an offer, and answer questions you receive.","isRequired":true,"uniqueKey":"offer_email.questions_emailed","typeLabel":"boolean"},"consent_url":{"oneOf":[{"description":"Owner-only URL.","type":"string","isRequired":true,"uniqueKey":"offer_email.consent_url.oneOf.0","typeLabel":"string"},{"description":"Owner-only URL.","type":"null","isRequired":true,"uniqueKey":"offer_email.consent_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"offer_email.consent_url","typeLabel":"string | null"}},"required":["request_enabled","permitted","questions_emailed","consent_url"],"additionalProperties":false,"uniqueKey":"offer_email","typeLabel":"object"},"possible_duplicate_of":{"description":"Open Requests of the same owner that closely match this new one: the same exact product references, the same top Need option set or the same words, with an overlapping destination. The new Request was saved anyway. If one is for the same thing, ask the person which to keep, then update or close the other so they are counted once.","maxItems":5,"type":"array","items":{"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":"possible_duplicate_of.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"match":{"type":"string","enum":["same_products","same_options","same_text"],"isRequired":true,"uniqueKey":"possible_duplicate_of.items.[INDEX].match","typeLabel":"enum\u003cstring>"}},"required":["id","match"],"additionalProperties":false,"uniqueKey":"possible_duplicate_of.items.[INDEX]","typeLabel":"object"},"uniqueKey":"possible_duplicate_of","typeLabel":"object[]"},"duplicate_hint":{"oneOf":[{"type":"string","uniqueKey":"duplicate_hint.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"duplicate_hint.oneOf.1","typeLabel":"null"}],"uniqueKey":"duplicate_hint","typeLabel":"string | null"},"save_confirmation":{"type":"object","properties":{"saved":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"save_confirmation.saved","typeLabel":"boolean"},"status":{"type":"string","enum":["draft","active","closed"],"isRequired":true,"uniqueKey":"save_confirmation.status","typeLabel":"enum\u003cstring>"},"counts_as":{"type":"string","enum":["interest_with_price_limit","interest_only"],"isRequired":true,"uniqueKey":"save_confirmation.counts_as","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"save_confirmation.message","typeLabel":"string"},"order_created":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"save_confirmation.order_created","typeLabel":"boolean"},"payment_taken":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"save_confirmation.payment_taken","typeLabel":"boolean"},"deal_promised":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"save_confirmation.deal_promised","typeLabel":"boolean"}},"required":["saved","status","counts_as","message","order_created","payment_taken","deal_promised"],"additionalProperties":false,"uniqueKey":"save_confirmation","typeLabel":"object"},"needs_attention":{"type":"array","items":{"type":"string","enum":["new_offer","open_question","details_needed","still_want","offer_ending"],"uniqueKey":"needs_attention.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"needs_attention","typeLabel":"enum\u003cstring>[]"},"attention":{"description":"Each needs_attention flag in words.","type":"array","items":{"type":"object","properties":{"flag":{"type":"string","enum":["new_offer","open_question","details_needed","still_want","offer_ending","request_ending"],"isRequired":true,"uniqueKey":"attention.items.[INDEX].flag","typeLabel":"enum\u003cstring>"},"message":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"attention.items.[INDEX].message.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"attention.items.[INDEX].message.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attention.items.[INDEX].message","typeLabel":"string | null"},"agent_line":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"attention.items.[INDEX].agent_line.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"attention.items.[INDEX].agent_line.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"attention.items.[INDEX].agent_line","typeLabel":"string | null"}},"required":["flag","message","agent_line"],"additionalProperties":false,"uniqueKey":"attention.items.[INDEX]","typeLabel":"object"},"uniqueKey":"attention","typeLabel":"object[]"},"next_step":{"oneOf":[{"description":"The one next step, or null.","type":"string","uniqueKey":"next_step.oneOf.0","typeLabel":"string"},{"description":"The one next step, or null.","type":"null","uniqueKey":"next_step.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_step","typeLabel":"string | null"},"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"},"open_questions":{"description":"Questions to answer with POST /api/purchases/{id}/answers before their deadline.","type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"open_questions.items.[INDEX].additionalProperties","typeLabel":"any"},"uniqueKey":"open_questions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"open_questions","typeLabel":"object[]"},"notifications":{"type":"object","properties":{"request_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"notifications.request_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"notifications.request_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"notifications.request_id","typeLabel":"string | null"},"offer_alerts":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"notifications.offer_alerts.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"notifications.offer_alerts.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"notifications.offer_alerts","typeLabel":"boolean | null"},"check_frequency":{"type":"string","isRequired":true,"uniqueKey":"notifications.check_frequency","typeLabel":"string"},"check_channels":{"type":"string","isRequired":true,"uniqueKey":"notifications.check_channels","typeLabel":"string"},"agent_reachability":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","isRequired":true,"uniqueKey":"notifications.agent_reachability.items.[INDEX].channel","typeLabel":"string"},"enabled":{"type":"boolean","isRequired":true,"uniqueKey":"notifications.agent_reachability.items.[INDEX].enabled","typeLabel":"boolean"},"expected_check_hours":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"notifications.agent_reachability.items.[INDEX].expected_check_hours.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"notifications.agent_reachability.items.[INDEX].expected_check_hours.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"notifications.agent_reachability.items.[INDEX].expected_check_hours","typeLabel":"number | null"}},"required":["channel","enabled","expected_check_hours"],"additionalProperties":false,"uniqueKey":"notifications.agent_reachability.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"notifications.agent_reachability","typeLabel":"object[]"}},"required":["request_id","offer_alerts","check_frequency","check_channels","agent_reachability"],"additionalProperties":false,"uniqueKey":"notifications","typeLabel":"object"},"supplier_text_is_untrusted":{"type":"boolean","const":true,"uniqueKey":"supplier_text_is_untrusted","typeLabel":"boolean"},"untrusted_text_fields":{"maxItems":20,"type":"array","items":{"type":"string","uniqueKey":"untrusted_text_fields.items.[INDEX]","typeLabel":"string"},"uniqueKey":"untrusted_text_fields","typeLabel":"string[]"}},"required":["blockers","next_actions","as_of","id","status","version","original_raw_request","raw_request","country","currency","destination","time_horizon","need_by","items","price_limits","delivery","all_items_required","resolution_status","research_status","source","created_via","origin_client_id","created_at","updated_at","expires_at","activated_at","last_reaffirmed_at","closed_at","closed_reason","observations","baseline","pricing","baseline_diagnostics","execution_available","execution_note","reachability","agent_events","polling_access","email_delivery","history","compatible_demand"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"blockers":["\u003cstring>"],"next_actions":[{"code":"\u003cstring>","actor":"\u003cstring>","message":"\u003cstring>"}],"as_of":"2023-11-07T05:31:56Z","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"draft","version":123,"original_raw_request":"\u003cstring>","raw_request":"\u003cstring>","country":"US","currency":"USD","destination":{"scope":"unknown","city":"\u003cstring>","region":"\u003cstring>","zip":"\u003cstring>","postal_code":"\u003cstring>"},"time_horizon":"\u003cstring>","need_by":"2023-11-07T05:31:56Z","items":[{"item_id":"\u003cstring>","description":"\u003cstring>","quantity":4503599627370495,"required":true,"confirmed":true,"options":[{"option_id":"\u003cstring>","description":"\u003cstring>","product":{"namespace":"\u003cstring>","item_id":"\u003cstring>"},"attributes":[{"name":"\u003cstring>","value":"\u003cstring>"}],"url":"\u003cstring>"}],"terms":{"warranty_months_min":0,"returns_days_min":0,"authorized_seller_required":true}}],"price_limits":[{"limit_id":"\u003cstring>","item_id":"\u003cstring>","includes_delivery_and_tax":true,"amount_minor":123,"currency":"USD","set_at":"2023-11-07T05:31:56Z"}],"delivery":["shipping"],"all_items_required":true,"resolution_status":"unresolved","research_status":"needs_research","source":"\u003cstring>","created_via":"web","origin_client_id":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","expires_at":"2023-11-07T05:31:56Z","activated_at":"2023-11-07T05:31:56Z","last_reaffirmed_at":"2023-11-07T05:31:56Z","closed_at":"2023-11-07T05:31:56Z","closed_reason":"\u003cstring>","observations":[{"outcome_description":"\u003cstring>","item_minor":50000000,"shipping_minor":50000000,"tax_minor":50000000,"duties_minor":50000000,"total_minor":50000000,"currency":"USD","source_url":"\u003cstring>","seller_name":"\u003cstring>","observed_at":"2023-11-07T05:31:56Z","valid_until":"2023-11-07T05:31:56Z","availability":"available","terms":{"warranty":"\u003cstring>","returns":"\u003cstring>","delivery":"\u003cstring>","legitimacy":"\u003cstring>","comparable":false,"all_in_confirmed":false},"confidence_note":"\u003cstring>","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","review_status":"provisional"}],"baseline":{"outcome_description":"\u003cstring>","item_minor":50000000,"shipping_minor":50000000,"tax_minor":50000000,"duties_minor":50000000,"total_minor":50000000,"currency":"USD","source_url":"\u003cstring>","seller_name":"\u003cstring>","observed_at":"2023-11-07T05:31:56Z","valid_until":"2023-11-07T05:31:56Z","availability":"available","terms":{"warranty":"\u003cstring>","returns":"\u003cstring>","delivery":"\u003cstring>","legitimacy":"\u003cstring>","comparable":false,"all_in_confirmed":false},"confidence_note":"\u003cstring>","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","review_status":"provisional"},"pricing":{"status":"exploratory","amount_minor":4503599627370495,"label":"\u003cstring>"},"baseline_diagnostics":{"status":"usable","checked_at":"2023-11-07T05:31:56Z","baseline_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","reason_codes":["context_changed"],"observations":[{"observation_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","eligible":true,"reasons":["context_changed"]}],"history_limit_reached":true},"execution_available":false,"execution_note":"\u003cstring>","reachability":[{"channel":"email","status":"active","verified_at":"2023-11-07T05:31:56Z","expected_check_hours":0,"last_polled_at":"2023-11-07T05:31:56Z","last_delivered_at":"2023-11-07T05:31:56Z"}],"agent_events":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","event_name":"request.research_updated","status":"active","expires_at":"2023-11-07T05:31:56Z","last_delivered_at":"2023-11-07T05:31:56Z"}],"polling_access":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","expires_at":"2023-11-07T05:31:56Z","last_polled_at":"2023-11-07T05:31:56Z"}],"email_delivery":"local_inbox","history":[{"type":"\u003cstring>","occurred_at":"2023-11-07T05:31:56Z","payload":{}}],"compatible_demand":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","title":"\u003cstring>","compatibility_rule":"\u003cstring>","geography_scope":"\u003cstring>","active_intents":"\u003cstring>","count_kind":"active_requests","executable_units":0,"observed_at":"2023-11-07T05:31:56Z"}],"buyer_status":{"state":"closed","label":"\u003cstring>","message":"\u003cstring>","matching_people":4503599627370495,"details":"item","matching_confirmation_counts":{"person":4503599627370495,"agent":4503599627370495,"unknown":4503599627370495},"item_counts":[{"need_id":"\u003cstring>","label":"\u003cstring>","products":[{"namespace":"\u003cstring>","item_id":"\u003cstring>"}],"people":4503599627370495}]},"exact_item_confirmation":{"confirmed_by":"person","confirmed_at":"2023-11-07T05:31:56Z","request_version":123},"draft_agent":"\u003cstring>","offer_email":{"request_enabled":true,"permitted":true,"questions_emailed":true,"consent_url":"\u003cstring>"},"possible_duplicate_of":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","match":"same_products"}],"duplicate_hint":"\u003cstring>","save_confirmation":{"saved":true,"status":"draft","counts_as":"interest_with_price_limit","message":"\u003cstring>","order_created":false,"payment_taken":false,"deal_promised":false},"needs_attention":["new_offer"],"attention":[{"flag":"new_offer","message":"\u003cstring>","agent_line":"\u003cstring>"}],"next_step":"\u003cstring>","message":"\u003cstring>","agent_line":"\u003cstring>","open_questions":[{}],"notifications":{"request_id":"\u003cstring>","offer_alerts":true,"check_frequency":"\u003cstring>","check_channels":"\u003cstring>","agent_reachability":[{"channel":"\u003cstring>","enabled":true,"expected_check_hours":123}]},"supplier_text_is_untrusted":true,"untrusted_text_fields":["\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"},"6b910bc9-91b1-4307-9848-d8e9bc65109a":{"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"},"eac64a5c-fa54-4c0b-9b94-077206063c9a":{"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"},"71e016c5-a807-4e21-aab3-14391669722c":{"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"},"28a90e20-84fd-4703-8f4d-b7f99262625b":{"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"},"45bf7741-3433-4937-9b94-1a99ff02c9b4":{"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"},"cd62497e-9f3b-4798-a732-82aae0908750":{"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"},"7e4d64cb-df26-410d-ac7f-7234faa0a882":{"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"},"3c84ab10-5401-412c-bcfc-d962421826f4":{"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"},"eaf08e15-8f38-4260-b111-822e8c335cd8":{"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":{"a23e9d3f-1374-4101-a7f8-89ab308f044d":{"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":{"e56e4a12-28aa-435a-b75d-84640adc9857":{"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/requests.json"},"subdomain":"popular-demand","siteName":"Popular Demand","title":"Save a Request - Popular Demand","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T13:23:17.583Z","originalFileLocation":"api-reference/requests/save-a-request.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=\"Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.\">\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=\"Save a Request - Popular Demand\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.\">\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/requests/save-a-request\">\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=Requests\u0026amp;title=Save+a+Request\u0026amp;description=Create+active+soft+demand+after+verified+ownership+and+explicit+user+authorization.+No+existing+market+or+variant+is+required.+Without+currency%2C+the+Request+use\u0026amp;theme=f691b217e7815ac0b6a128d0\u0026amp;signature=ee249b3565d09341995fbb6e32cb9d6de4e41ba6e9a4ea7b457ea467d1861eaf\">\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=\"Save a Request - Popular Demand\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://popular-demand.mintlify.site/_mintlify/api/og/v2?division=Requests\u0026amp;title=Save+a+Request\u0026amp;description=Create+active+soft+demand+after+verified+ownership+and+explicit+user+authorization.+No+existing+market+or+variant+is+required.+Without+currency%2C+the+Request+use\u0026amp;theme=f691b217e7815ac0b6a128d0\u0026amp;signature=ee249b3565d09341995fbb6e32cb9d6de4e41ba6e9a4ea7b457ea467d1861eaf\">\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/requests/save-a-request\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/requests/save-a-request.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/requests/save-a-request#webpage\",\"url\":\"https://docs.populardemand.market/api-reference/requests/save-a-request\",\"name\":\"Save a Request\",\"description\":\"Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.\",\"dateModified\":\"2026-11-20T13:23:17.583Z\",\"isPartOf\":{\"@id\":\"https://docs.populardemand.market#website\"},\"breadcrumb\":{\"@id\":\"https://docs.populardemand.market/api-reference/requests/save-a-request#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.populardemand.market/api-reference/requests/save-a-request#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Requests\",\"item\":\"https://docs.populardemand.market/api-reference/requests/list-requests\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Requests\",\"item\":\"https://docs.populardemand.market/api-reference/requests/list-requests\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Save a Request\",\"item\":\"https://docs.populardemand.market/api-reference/requests/save-a-request\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.populardemand.market/api-reference/requests/save-a-request#apireference\",\"headline\":\"Save a Request\",\"name\":\"Save a Request\",\"description\":\"Create active soft demand after verified ownership and explicit user authorization. No existing market or variant is required. Without currency, the Request uses its country’s currency (US/USD, IL/ILS). The response has save_confirmation: relay it as it is.\",\"url\":\"https://docs.populardemand.market/api-reference/requests/save-a-request\",\"mainEntityOfPage\":{\"@id\":\"https://docs.populardemand.market/api-reference/requests/save-a-request#webpage\"},\"dateModified\":\"2026-11-20T13:23:17.583Z\",\"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/requests/save-a-request.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","description":"List owned Request summaries within the approved agent scope. Includes actual blockers and useful next actions. Fetch detail_url for evidence diagnostics and history. Reading does not reaffirm interest. Without paging parameters the response is up to 100 summaries of open Requests under the intents key. With limit, status, before_created_at or before_id the response is one PurchaseListPage of at most 20, newest first: pass next_cursor back as before_created_at and before_id until it is null, to read every Request. Each summary has needs_attention, as list_requests does.","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","description":"Private status, conditions, evidence diagnostics, effective pricing, reachability and history. A read-only capability grants access to one purchase; cannot write. Reading records polling activity separately from freshness. The owner’s read also has needs_attention, open_questions and notifications, as get_request does.","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","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","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":"Save a Request - 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"]}