{"openapi":"3.1.0","info":{"title":"RewardsBot API","description":"API for RewardsBot chat, content, offer, and webhook workflows.","version":"0.4.1"},"paths":{"/spy/{convo_id}":{"get":{"summary":"Spy State","operationId":"spy_state_spy__convo_id__get","parameters":[{"name":"convo_id","in":"path","required":true,"schema":{"type":"string","title":"Convo Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/{convo_id}":{"post":{"summary":"Chat","operationId":"chat_chat__convo_id__post","parameters":[{"name":"convo_id","in":"path","required":true,"schema":{"type":"string","title":"Convo Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopperInput"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopperReply"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/inventory/ranking-sessions/{conversation_id}/{ranking_session_id}/pages/{page_index}":{"get":{"tags":["inventory"],"summary":"Get Ranking Session Page","operationId":"get_ranking_session_page_inventory_ranking_sessions__conversation_id___ranking_session_id__pages__page_index__get","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"ranking_session_id","in":"path","required":true,"schema":{"type":"string","title":"Ranking Session Id"}},{"name":"page_index","in":"path","required":true,"schema":{"type":"integer","title":"Page Index"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryPaginationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/products/search":{"post":{"tags":["affiliate-discovery"],"summary":"Search Affiliate Discovery Products","operationId":"search_affiliate_discovery_products_v1_discovery_products_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoverySearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoverySearchResponse"}}}},"403":{"description":"Missing API key."},"404":{"description":"Cursor or backing ranking session not found."},"410":{"description":"Cursor or backing ranking session has expired."},"416":{"description":"Cursor page is out of range."},"503":{"description":"Cursor-backed affiliate discovery search is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/discovery/products/criteria-sets":{"get":{"tags":["affiliate-discovery"],"summary":"List Affiliate Discovery Criteria Sets","operationId":"list_affiliate_discovery_criteria_sets_v1_discovery_products_criteria_sets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoveryCriteriaSetListResponse"}}}},"403":{"description":"Missing API key."},"503":{"description":"Affiliate discovery criteria set storage is not configured."}},"security":[{"ApiKeyAuth":[]}]},"post":{"tags":["affiliate-discovery"],"summary":"Create Affiliate Discovery Criteria Set","operationId":"create_affiliate_discovery_criteria_set_v1_discovery_products_criteria_sets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoveryCriteriaSetInput"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoveryCriteriaSet"}}}},"403":{"description":"Missing API key."},"409":{"description":"Criteria set already exists."},"503":{"description":"Affiliate discovery criteria set storage is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/discovery/products/criteria-sets/{criteria_set_id}":{"get":{"tags":["affiliate-discovery"],"summary":"Get Affiliate Discovery Criteria Set","operationId":"get_affiliate_discovery_criteria_set_v1_discovery_products_criteria_sets__criteria_set_id__get","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"criteria_set_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$","title":"Criteria Set Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoveryCriteriaSet"}}}},"403":{"description":"Missing API key."},"404":{"description":"Criteria set not found."},"503":{"description":"Affiliate discovery criteria set storage is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["affiliate-discovery"],"summary":"Upsert Affiliate Discovery Criteria Set","operationId":"upsert_affiliate_discovery_criteria_set_v1_discovery_products_criteria_sets__criteria_set_id__put","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"criteria_set_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$","title":"Criteria Set Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoveryCriteriaSetInput"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoveryCriteriaSet"}}}},"403":{"description":"Missing API key."},"422":{"description":"Criteria set path and body IDs do not match."},"503":{"description":"Affiliate discovery criteria set storage is not configured."}}},"delete":{"tags":["affiliate-discovery"],"summary":"Delete Affiliate Discovery Criteria Set","operationId":"delete_affiliate_discovery_criteria_set_v1_discovery_products_criteria_sets__criteria_set_id__delete","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"criteria_set_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$","title":"Criteria Set Id"}}],"responses":{"204":{"description":"Successful Response"},"403":{"description":"Missing API key."},"503":{"description":"Affiliate discovery criteria set storage is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/products/{slug}":{"get":{"tags":["affiliate-discovery"],"summary":"Get Affiliate Discovery Product Details","operationId":"get_affiliate_discovery_product_details_v1_discovery_products__slug__get","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoveryProductDetailResponse"}}}},"403":{"description":"Missing API key."},"404":{"description":"Product slug or backing ranking session not found."},"410":{"description":"Product slug or backing ranking session has expired."},"416":{"description":"Product slug page or item is out of range."},"503":{"description":"Affiliate Discovery API is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/merchants":{"get":{"tags":["affiliate-discovery"],"summary":"List Affiliate Discovery Merchants","operationId":"list_affiliate_discovery_merchants_v1_discovery_merchants_get","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Per Page"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoveryMerchantListResponse"}}}},"403":{"description":"Missing API key."},"503":{"description":"Affiliate Discovery merchant search is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/discovery/merchants/search":{"get":{"tags":["affiliate-discovery"],"summary":"Search Affiliate Discovery Merchants","operationId":"search_affiliate_discovery_merchants_v1_discovery_merchants_search_get","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Query"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Per Page"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AffiliateDiscoveryMerchantListResponse"}}}},"403":{"description":"Missing API key."},"503":{"description":"Affiliate Discovery merchant search is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/clickthrough/{convo_id}":{"post":{"summary":"Clickthrough To Offer","operationId":"clickthrough_to_offer_clickthrough__convo_id__post","parameters":[{"name":"convo_id","in":"path","required":true,"schema":{"type":"string","title":"Convo Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductClick"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/clickthrough/{convo_id}/{presentment_id}":{"get":{"summary":"Clickthrough Redirect","operationId":"clickthrough_redirect_clickthrough__convo_id___presentment_id__get","parameters":[{"name":"convo_id","in":"path","required":true,"schema":{"type":"string","title":"Convo Id"}},{"name":"presentment_id","in":"path","required":true,"schema":{"type":"string","title":"Presentment Id"}},{"name":"email","in":"query","required":true,"schema":{"type":"string","title":"Email"}},{"name":"program","in":"query","required":true,"schema":{"type":"string","title":"Program"}},{"name":"click_id","in":"query","required":true,"schema":{"type":"string","title":"Click Id"}},{"name":"click_datetime","in":"query","required":true,"schema":{"type":"string","format":"date-time","title":"Click Datetime"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/signup/{convo_id}":{"post":{"summary":"Register Signup","operationId":"register_signup_signup__convo_id__post","parameters":[{"name":"convo_id","in":"path","required":true,"schema":{"type":"string","title":"Convo Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupSubmission"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/offers/multi":{"post":{"tags":["offers"],"summary":"Build Offers","operationId":"build_offers_offers_multi_post","requestBody":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OfferMessage"},"type":"array","title":"Offer Messages"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"items":{"$ref":"#/components/schemas/OfferReference"},"type":"array"},{"items":{"$ref":"#/components/schemas/MessageAck"},"type":"array"}],"title":"Response Build Offers Offers Multi Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/offers/single":{"post":{"tags":["offers"],"summary":"Build Offer","operationId":"build_offer_offers_single_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferMessage"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OfferReference"},{"$ref":"#/components/schemas/MessageAck"}],"title":"Response Build Offer Offers Single Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/offers/carousel":{"post":{"tags":["offers"],"summary":"Build Carousel Offer","operationId":"build_carousel_offer_offers_carousel_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferMessage"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OfferReference"},{"$ref":"#/components/schemas/MessageAck"}],"title":"Response Build Carousel Offer Offers Carousel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/offers/retry/{convo_id}/{presentment_id}":{"get":{"tags":["offers"],"summary":"Retry Offer","operationId":"retry_offer_offers_retry__convo_id___presentment_id__get","parameters":[{"name":"convo_id","in":"path","required":true,"schema":{"type":"string","title":"Convo Id"}},{"name":"presentment_id","in":"path","required":true,"schema":{"type":"string","title":"Presentment Id"}},{"name":"email","in":"query","required":true,"schema":{"type":"string","title":"Email"}},{"name":"program","in":"query","required":true,"schema":{"type":"string","title":"Program"}},{"name":"click_id","in":"query","required":true,"schema":{"type":"string","title":"Click Id"}},{"name":"click_datetime","in":"query","required":true,"schema":{"type":"string","format":"date-time","title":"Click Datetime"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/OfferReference"},{"$ref":"#/components/schemas/MessageAck"}],"title":"Response Retry Offer Offers Retry  Convo Id   Presentment Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AffiliateDiscoveryCriteriaSet":{"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$","title":"Id"},"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"query":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Query"},"exclude_query":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Exclude Query"},"criteria":{"items":{"$ref":"#/components/schemas/DiscriminatedInventoryCriterion"},"type":"array","title":"Criteria"},"type":{"type":"string","const":"affiliate_discovery_criteria_set","title":"Type","default":"affiliate_discovery_criteria_set"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"additionalProperties":false,"type":"object","required":["id","name","created_at","updated_at"],"title":"AffiliateDiscoveryCriteriaSet","x-contract-version":"1.1.0"},"AffiliateDiscoveryCriteriaSetInput":{"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$","title":"Id"},"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"query":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Query"},"exclude_query":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Exclude Query"},"criteria":{"items":{"$ref":"#/components/schemas/DiscriminatedInventoryCriterion"},"type":"array","title":"Criteria"}},"additionalProperties":false,"type":"object","required":["id","name"],"title":"AffiliateDiscoveryCriteriaSetInput","x-contract-version":"1.1.0"},"AffiliateDiscoveryCriteriaSetListResponse":{"properties":{"type":{"type":"string","const":"affiliate_discovery_criteria_set_list","title":"Type","default":"affiliate_discovery_criteria_set_list"},"items":{"items":{"$ref":"#/components/schemas/AffiliateDiscoveryCriteriaSet"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"AffiliateDiscoveryCriteriaSetListResponse","x-contract-version":"1.1.0"},"AffiliateDiscoveryMerchant":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"}},"type":"object","title":"AffiliateDiscoveryMerchant","x-contract-version":"1.1.0"},"AffiliateDiscoveryMerchantListItem":{"properties":{"type":{"type":"string","const":"merchant","title":"Type","default":"merchant"},"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"merchant_ids":{"items":{"type":"string"},"type":"array","title":"Merchant Ids"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"network_names":{"items":{"type":"string"},"type":"array","title":"Network Names"},"countries":{"items":{"type":"string"},"type":"array","title":"Countries"},"product_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Product Count"},"tranco_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tranco Rank"},"tranco_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tranco Score"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"brands":{"items":{"type":"string"},"type":"array","title":"Brands"},"product_terms":{"items":{"type":"string"},"type":"array","title":"Product Terms"},"default_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Default Rank"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"}},"type":"object","required":["id","name"],"title":"AffiliateDiscoveryMerchantListItem","x-contract-version":"1.1.0"},"AffiliateDiscoveryMerchantListResponse":{"properties":{"query":{"type":"string","title":"Query"},"page_index":{"type":"integer","title":"Page Index"},"page_size":{"type":"integer","title":"Page Size"},"items":{"items":{"$ref":"#/components/schemas/AffiliateDiscoveryMerchantListItem"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["query","page_index","page_size","items"],"title":"AffiliateDiscoveryMerchantListResponse","x-contract-version":"1.1.0"},"AffiliateDiscoveryPrice":{"properties":{"display":{"type":"string","title":"Display"},"value":{"type":"number","title":"Value"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"regular_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Regular Value"},"final_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Final Value"},"on_sale":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Sale"},"sale_discount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sale Discount"}},"type":"object","required":["display","value"],"title":"AffiliateDiscoveryPrice","x-contract-version":"1.1.0"},"AffiliateDiscoveryProduct":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"image_url":{"type":"string","title":"Image Url"},"product_url":{"type":"string","title":"Product Url"},"merchant_url":{"type":"string","title":"Merchant Url"},"price":{"$ref":"#/components/schemas/AffiliateDiscoveryPrice"},"merchant":{"anyOf":[{"$ref":"#/components/schemas/AffiliateDiscoveryMerchant"},{"type":"null"}]},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"availability":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Availability"}},"type":"object","required":["id","name","description","image_url","product_url","merchant_url","price"],"title":"AffiliateDiscoveryProduct","x-contract-version":"1.1.0"},"AffiliateDiscoveryProductDetailResponse":{"properties":{"type":{"type":"string","const":"product_detail","title":"Type","default":"product_detail"},"item":{"$ref":"#/components/schemas/AffiliateDiscoveryProduct"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["item"],"title":"AffiliateDiscoveryProductDetailResponse","x-contract-version":"1.1.0"},"AffiliateDiscoverySearchItem":{"properties":{"type":{"type":"string","const":"product","title":"Type","default":"product"},"slug":{"type":"string","title":"Slug"},"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"image_url":{"type":"string","title":"Image Url"},"product_url":{"type":"string","title":"Product Url"},"merchant_url":{"type":"string","title":"Merchant Url"},"price":{"$ref":"#/components/schemas/AffiliateDiscoveryPrice"},"merchant":{"anyOf":[{"$ref":"#/components/schemas/AffiliateDiscoveryMerchant"},{"type":"null"}]},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"availability":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Availability"}},"type":"object","required":["slug","id","name","image_url","product_url","merchant_url","price"],"title":"AffiliateDiscoverySearchItem","x-contract-version":"1.1.0"},"AffiliateDiscoverySearchRequest":{"properties":{"query":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Query","description":"Free-text query string."},"criteria_set_ids":{"items":{"type":"string"},"type":"array","title":"Criteria Set Ids","description":"Saved criteria set IDs to apply to this first-page search."},"exclude_query":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Exclude Query","description":"Negative free-text provider filter applied to 'name||description||brand'."},"criteria":{"items":{"$ref":"#/components/schemas/DiscriminatedInventoryCriterion"},"type":"array","title":"Criteria","description":"Structured filters applied in addition to the free-text query."},"per_page":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Per Page","description":"Maximum number of products requested for the page.","default":25},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor","description":"Opaque cursor returned by a previous search response."}},"additionalProperties":false,"type":"object","title":"AffiliateDiscoverySearchRequest","examples":[{"criteria":[{"field":"on_sale","operator":"=","value":true},{"field":"in_stock","operator":"=","value":true}],"criteria_set_ids":["summer-sale"],"exclude_query":"trail hiking","per_page":25,"query":"running shoes"},{"cursor":"opaque-next-page-cursor"}],"x-contract-version":"1.1.0"},"AffiliateDiscoverySearchResponse":{"properties":{"query":{"type":"string","title":"Query"},"page_index":{"type":"integer","title":"Page Index"},"page_size":{"type":"integer","title":"Page Size"},"items":{"items":{"$ref":"#/components/schemas/AffiliateDiscoverySearchItem"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["query","page_index","page_size","items"],"title":"AffiliateDiscoverySearchResponse","x-contract-version":"1.1.0"},"AnyCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"any","title":"Field","default":"any"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"AnyCriterion","example":{"field":"any","operator":"not_like","value":"trail hiking"}},"AsinCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"asin","title":"Field","default":"asin"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"AsinCriterion","example":{"field":"asin","operator":"=","value":"B000123456"}},"AvailabilityCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"availability","title":"Field","default":"availability"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"AvailabilityCriterion","example":{"field":"availability","operator":"=","value":"in_stock"}},"BarcodeCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"barcode","title":"Field","default":"barcode"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"BarcodeCriterion","example":{"field":"barcode","operator":"=","value":"012345678905"}},"BooleanOperator":{"type":"string","enum":["=","!="],"title":"BooleanOperator"},"BrandCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"brand","title":"Field","default":"brand"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"BrandCriterion","example":{"field":"brand","operator":"=","value":"Nike"}},"CandidateDiversity":{"properties":{"merchant_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Merchant Key"},"brand_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Key"},"family_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Family Key"}},"type":"object","title":"CandidateDiversity"},"CategoryCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"category","title":"Field","default":"category"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"CategoryCriterion","example":{"field":"category","operator":"like","value":"running shoe"}},"ColorCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"color","title":"Field","default":"color"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"ColorCriterion","example":{"field":"color","operator":"=","value":"red"}},"ConditionCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"condition","title":"Field","default":"condition"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"ConditionCriterion","example":{"field":"condition","operator":"=","value":"new"}},"CountryCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"country","title":"Field","default":"country"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"CountryCriterion","example":{"field":"country","operator":"=","value":"US"}},"CurrencyCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"currency","title":"Field","default":"currency"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"CurrencyCriterion","example":{"field":"currency","operator":"=","value":"USD"}},"DiscriminatedInventoryCriterion":{"oneOf":[{"$ref":"#/components/schemas/AnyCriterion"},{"$ref":"#/components/schemas/NameDescriptionBrandCriterion"},{"$ref":"#/components/schemas/BrandCriterion"},{"$ref":"#/components/schemas/CategoryCriterion"},{"$ref":"#/components/schemas/ColorCriterion"},{"$ref":"#/components/schemas/ConditionCriterion"},{"$ref":"#/components/schemas/CountryCriterion"},{"$ref":"#/components/schemas/GenderCriterion"},{"$ref":"#/components/schemas/GenreCriterion"},{"$ref":"#/components/schemas/ManufacturerCriterion"},{"$ref":"#/components/schemas/MaterialCriterion"},{"$ref":"#/components/schemas/ModelCriterion"},{"$ref":"#/components/schemas/PublisherCriterion"},{"$ref":"#/components/schemas/SizeCriterion"},{"$ref":"#/components/schemas/SubtitleCriterion"},{"$ref":"#/components/schemas/TagsCriterion"},{"$ref":"#/components/schemas/CurrencyCriterion"},{"$ref":"#/components/schemas/OnSaleCriterion"},{"$ref":"#/components/schemas/SaleDiscountCriterion"},{"$ref":"#/components/schemas/RegularPriceCriterion"},{"$ref":"#/components/schemas/FinalPriceCriterion"},{"$ref":"#/components/schemas/SalePriceCriterion"},{"$ref":"#/components/schemas/ShipPriceCriterion"},{"$ref":"#/components/schemas/IdCriterion"},{"$ref":"#/components/schemas/BarcodeCriterion"},{"$ref":"#/components/schemas/SkuCriterion"},{"$ref":"#/components/schemas/MpnCriterion"},{"$ref":"#/components/schemas/AsinCriterion"},{"$ref":"#/components/schemas/MerchantIdCriterion"},{"$ref":"#/components/schemas/MerchantNameCriterion"},{"$ref":"#/components/schemas/SellerPartyCriterion"},{"$ref":"#/components/schemas/MerchantCategoryIdsCriterion"},{"$ref":"#/components/schemas/InStockCriterion"},{"$ref":"#/components/schemas/StockQuantityCriterion"},{"$ref":"#/components/schemas/AvailabilityCriterion"}],"discriminator":{"propertyName":"field","mapping":{"any":"#/components/schemas/AnyCriterion","asin":"#/components/schemas/AsinCriterion","availability":"#/components/schemas/AvailabilityCriterion","barcode":"#/components/schemas/BarcodeCriterion","brand":"#/components/schemas/BrandCriterion","category":"#/components/schemas/CategoryCriterion","color":"#/components/schemas/ColorCriterion","condition":"#/components/schemas/ConditionCriterion","country":"#/components/schemas/CountryCriterion","currency":"#/components/schemas/CurrencyCriterion","final_price":"#/components/schemas/FinalPriceCriterion","gender":"#/components/schemas/GenderCriterion","genre":"#/components/schemas/GenreCriterion","id":"#/components/schemas/IdCriterion","in_stock":"#/components/schemas/InStockCriterion","manufacturer":"#/components/schemas/ManufacturerCriterion","material":"#/components/schemas/MaterialCriterion","merchant.id":"#/components/schemas/MerchantIdCriterion","merchant.name":"#/components/schemas/MerchantNameCriterion","merchant_category_ids":"#/components/schemas/MerchantCategoryIdsCriterion","model":"#/components/schemas/ModelCriterion","mpn":"#/components/schemas/MpnCriterion","name||description||brand":"#/components/schemas/NameDescriptionBrandCriterion","on_sale":"#/components/schemas/OnSaleCriterion","publisher":"#/components/schemas/PublisherCriterion","regular_price":"#/components/schemas/RegularPriceCriterion","sale_discount":"#/components/schemas/SaleDiscountCriterion","sale_price":"#/components/schemas/SalePriceCriterion","seller_party":"#/components/schemas/SellerPartyCriterion","ship_price":"#/components/schemas/ShipPriceCriterion","size":"#/components/schemas/SizeCriterion","sku":"#/components/schemas/SkuCriterion","stock_quantity":"#/components/schemas/StockQuantityCriterion","subtitle":"#/components/schemas/SubtitleCriterion","tags":"#/components/schemas/TagsCriterion"}}},"FinalPriceCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/NumericOperator"},"value":{"type":"number","title":"Value"},"field":{"type":"string","const":"final_price","title":"Field","default":"final_price"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"FinalPriceCriterion","example":{"field":"final_price","operator":"<=","value":149.99}},"GenderCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"gender","title":"Field","default":"gender"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"GenderCriterion","example":{"field":"gender","operator":"=","value":"women"}},"GenreCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"genre","title":"Field","default":"genre"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"GenreCriterion","example":{"field":"genre","operator":"=","value":"fiction"}},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IdCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"id","title":"Field","default":"id"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"IdCriterion","example":{"field":"id","operator":"=","value":"sku-123"}},"InStockCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/BooleanOperator"},"value":{"type":"boolean","title":"Value"},"field":{"type":"string","const":"in_stock","title":"Field","default":"in_stock"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"InStockCriterion","example":{"field":"in_stock","operator":"=","value":true}},"InventoryPaginationItem":{"properties":{"candidate_id":{"type":"string","title":"Candidate Id"},"source_name":{"type":"string","title":"Source Name"},"product":{"$ref":"#/components/schemas/ProductInfo"},"rank":{"type":"integer","title":"Rank"},"diversity":{"$ref":"#/components/schemas/CandidateDiversity"}},"type":"object","required":["candidate_id","source_name","product","rank","diversity"],"title":"InventoryPaginationItem"},"InventoryPaginationMetadata":{"properties":{"type":{"type":"string","const":"inventory_pagination","title":"Type","default":"inventory_pagination"},"conversation_id":{"type":"string","title":"Conversation Id"},"session_id":{"type":"string","title":"Session Id"},"current_page":{"type":"integer","title":"Current Page"},"page_size":{"type":"integer","title":"Page Size"},"page_count":{"type":"integer","title":"Page Count"},"has_next_page":{"type":"boolean","title":"Has Next Page"},"next_page_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Page Index"},"next_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Page Url"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["conversation_id","session_id","current_page","page_size","page_count","has_next_page"],"title":"InventoryPaginationMetadata"},"InventoryPaginationResponse":{"properties":{"type":{"type":"string","const":"inventory_pagination","title":"Type","default":"inventory_pagination"},"conversation_id":{"type":"string","title":"Conversation Id"},"session_id":{"type":"string","title":"Session Id"},"query":{"type":"string","title":"Query"},"page_index":{"type":"integer","title":"Page Index"},"page_size":{"type":"integer","title":"Page Size"},"has_next_page":{"type":"boolean","title":"Has Next Page"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"items":{"items":{"$ref":"#/components/schemas/InventoryPaginationItem"},"type":"array","title":"Items"}},"type":"object","required":["conversation_id","session_id","query","page_index","page_size","has_next_page","items"],"title":"InventoryPaginationResponse"},"ManufacturerCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"manufacturer","title":"Field","default":"manufacturer"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"ManufacturerCriterion","example":{"field":"manufacturer","operator":"=","value":"Acme"}},"MaterialCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"material","title":"Field","default":"material"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"MaterialCriterion","example":{"field":"material","operator":"=","value":"leather"}},"Merchant":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"}},"type":"object","required":["id","name"],"title":"Merchant"},"MerchantCategoryIdsCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"merchant_category_ids","title":"Field","default":"merchant_category_ids"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"MerchantCategoryIdsCriterion","example":{"field":"merchant_category_ids","operator":"like","value":"shoes"}},"MerchantIdCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"merchant.id","title":"Field","default":"merchant.id"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"MerchantIdCriterion","example":{"field":"merchant.id","operator":"=","value":"merchant-42"}},"MerchantNameCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"merchant.name","title":"Field","default":"merchant.name"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"MerchantNameCriterion","example":{"field":"merchant.name","operator":"=","value":"Example Store"}},"MessageAck":{"properties":{"message_type":{"type":"string","title":"Message Type"},"message_id":{"type":"string","title":"Message Id"},"target":{"type":"string","title":"Target"},"data":{"additionalProperties":true,"type":"object"}},"type":"object","required":["message_type","message_id","target","data"],"title":"MessageAck"},"MessageTypeable":{"properties":{},"type":"object","title":"MessageTypeable"},"ModelCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"model","title":"Field","default":"model"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"ModelCriterion","example":{"field":"model","operator":"=","value":"Pegasus 41"}},"MpnCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"mpn","title":"Field","default":"mpn"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"MpnCriterion","example":{"field":"mpn","operator":"=","value":"MPN-123"}},"NameDescriptionBrandCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"name||description||brand","title":"Field","default":"name||description||brand"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"NameDescriptionBrandCriterion","example":{"field":"name||description||brand","operator":"not_like","value":"trail hiking"}},"NoRefinementReason":{"properties":{"reason":{"type":"string","title":"Reason"}},"type":"object","required":["reason"],"title":"NoRefinementReason"},"NumericOperator":{"type":"string","enum":["=","!=",">=","<="],"title":"NumericOperator"},"OfferMessage":{"properties":{"product_click":{"$ref":"#/components/schemas/ProductClick"},"product_info":{"$ref":"#/components/schemas/ProductInfo"}},"type":"object","required":["product_click","product_info"],"title":"OfferMessage"},"OfferReference":{"properties":{"id":{"type":"integer","title":"Id"}},"type":"object","required":["id"],"title":"OfferReference","description":"Simple handle to an offer object primary key"},"OnSaleCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/BooleanOperator"},"value":{"type":"boolean","title":"Value"},"field":{"type":"string","const":"on_sale","title":"Field","default":"on_sale"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"OnSaleCriterion","example":{"field":"on_sale","operator":"=","value":true}},"ProductClick":{"properties":{"program":{"type":"string","title":"Program"},"email":{"type":"string","title":"Email"},"convo_id":{"type":"string","title":"Convo Id"},"presentation_id":{"type":"string","title":"Presentation Id"},"click_id":{"type":"string","title":"Click Id"},"click_datetime":{"type":"string","format":"date-time","title":"Click Datetime"},"product_info":{"anyOf":[{"$ref":"#/components/schemas/ProductInfo"},{"type":"null"}]}},"type":"object","required":["program","email","convo_id","presentation_id","click_id","click_datetime"],"title":"ProductClick"},"ProductFilterSelection":{"properties":{"low_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Low Price"},"high_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"High Price"}},"type":"object","title":"ProductFilterSelection"},"ProductInfo":{"properties":{"name":{"type":"string","title":"Name"},"direct_link":{"type":"string","title":"Direct Link"},"detail_link":{"type":"string","title":"Detail Link"},"image_url":{"type":"string","title":"Image Url"},"value":{"type":"number","title":"Value"},"price":{"type":"string","title":"Price"},"description":{"type":"string","title":"Description"},"source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Name"},"rebate_pct":{"type":"number","title":"Rebate Pct","default":0.0},"presentment_id":{"type":"string","title":"Presentment Id"},"merchant":{"anyOf":[{"$ref":"#/components/schemas/Merchant"},{"type":"null"}]},"affiliate_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Affiliate Id"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"regular_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Regular Price"},"final_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Final Price"},"on_sale":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Sale"},"sale_discount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sale Discount"},"availability":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Availability"},"stock_quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Stock Quantity"},"commissionable_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commissionable Status"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size"},"color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Color"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Condition"}},"type":"object","required":["name","direct_link","detail_link","image_url","value","price","description"],"title":"ProductInfo"},"PublisherCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"publisher","title":"Field","default":"publisher"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"PublisherCriterion","example":{"field":"publisher","operator":"=","value":"Penguin"}},"RefinementOptions":{"properties":{"category":{"type":"string","title":"Category"},"options":{"items":{"type":"string"},"type":"array","title":"Options"}},"type":"object","required":["category","options"],"title":"RefinementOptions"},"RefinementSelection":{"properties":{"category":{"type":"string","title":"Category"},"selection":{"type":"string","title":"Selection"}},"type":"object","required":["category","selection"],"title":"RefinementSelection"},"RegularPriceCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/NumericOperator"},"value":{"type":"number","title":"Value"},"field":{"type":"string","const":"regular_price","title":"Field","default":"regular_price"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"RegularPriceCriterion","example":{"field":"regular_price","operator":"<=","value":200.0}},"SaleDiscountCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/NumericOperator"},"value":{"type":"number","title":"Value"},"field":{"type":"string","const":"sale_discount","title":"Field","default":"sale_discount"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"SaleDiscountCriterion","example":{"field":"sale_discount","operator":">=","value":0.1}},"SalePriceCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/NumericOperator"},"value":{"type":"number","title":"Value"},"field":{"type":"string","const":"sale_price","title":"Field","default":"sale_price"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"SalePriceCriterion","example":{"field":"sale_price","operator":"<=","value":129.99}},"SellerPartyCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"seller_party","title":"Field","default":"seller_party"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"SellerPartyCriterion","example":{"field":"seller_party","operator":"=","value":"first_party"}},"ShipPriceCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/NumericOperator"},"value":{"type":"number","title":"Value"},"field":{"type":"string","const":"ship_price","title":"Field","default":"ship_price"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"ShipPriceCriterion","example":{"field":"ship_price","operator":"<=","value":9.99}},"ShopperInput":{"properties":{"chat":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chat"},"refinement_selection":{"anyOf":[{"$ref":"#/components/schemas/RefinementSelection"},{"type":"null"}]},"product_filter":{"anyOf":[{"$ref":"#/components/schemas/ProductFilterSelection"},{"type":"null"}]}},"type":"object","title":"ShopperInput"},"ShopperReply":{"properties":{"agent_reply":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Reply"},"found_products":{"anyOf":[{"$ref":"#/components/schemas/StoreInventory"},{"type":"null"}]},"product_warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Warning"},"refinement_result":{"anyOf":[{"$ref":"#/components/schemas/RefinementOptions"},{"$ref":"#/components/schemas/NoRefinementReason"},{"type":"null"}],"title":"Refinement Result"},"pagination":{"anyOf":[{"$ref":"#/components/schemas/InventoryPaginationMetadata"},{"type":"null"}]},"refinements":{"anyOf":[{"$ref":"#/components/schemas/RefinementOptions"},{"type":"null"}],"readOnly":true}},"type":"object","required":["agent_reply","refinements"],"title":"ShopperReply"},"SignupSubmission":{"properties":{"program":{"type":"string","title":"Program"},"email":{"type":"string","title":"Email"},"presentation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Presentation Id"},"card_bin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Card Bin"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"utm":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Utm"},"product_info":{"anyOf":[{"$ref":"#/components/schemas/ProductInfo"},{"type":"null"}]}},"type":"object","required":["program","email"],"title":"SignupSubmission"},"SizeCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"size","title":"Field","default":"size"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"SizeCriterion","example":{"field":"size","operator":"=","value":"10"}},"SkuCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"sku","title":"Field","default":"sku"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"SkuCriterion","example":{"field":"sku","operator":"=","value":"SKU-123"}},"StockQuantityCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/NumericOperator"},"value":{"type":"number","title":"Value"},"field":{"type":"string","const":"stock_quantity","title":"Field","default":"stock_quantity"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"StockQuantityCriterion","example":{"field":"stock_quantity","operator":">=","value":1}},"StoreInventory":{"properties":{"query":{"type":"string","title":"Query"},"search_results":{"additionalProperties":{"items":{"$ref":"#/components/schemas/ProductInfo"},"type":"array"},"type":"object","title":"Search Results"},"presentment_set_id":{"type":"string","title":"Presentment Set Id"},"price_range":{"anyOf":[{"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array","maxItems":2,"minItems":2},{"type":"null"}],"title":"Price Range","readOnly":true}},"type":"object","required":["query","search_results","price_range"],"title":"StoreInventory"},"SubtitleCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"subtitle","title":"Field","default":"subtitle"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"SubtitleCriterion","example":{"field":"subtitle","operator":"like","value":"collector edition"}},"TagsCriterion":{"properties":{"operator":{"$ref":"#/components/schemas/TextOperator"},"value":{"type":"string","minLength":1,"title":"Value"},"field":{"type":"string","const":"tags","title":"Field","default":"tags"}},"additionalProperties":false,"type":"object","required":["operator","value"],"title":"TagsCriterion","example":{"field":"tags","operator":"like","value":"trail"}},"TextOperator":{"type":"string","enum":["=","!=","like","not_like"],"title":"TextOperator"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Optional bearer token parsed from the Authorization header."}}}}