{"schema_version":"1.0","endpoint":"/api/v1/handshake/create","authentication":"Sites user identity required; service access alone does not authorize a shopper profile.","consent":"shopper_approved must be true after specific transfer approval. Every imported answer still needs shopper review in Somni. Retailer sharing is separate.","agent_policy":{"assistance_allowed":true,"identity":"Authenticate as the individual shopper who authorized this transfer. A shared agent account does not represent multiple unrelated customers.","rate_limits":"Account limits apply across IP addresses. Exact retries reuse request_id; on HTTP 429 respect Retry-After. Do not rotate accounts, networks or identifiers to evade limits.","trust":"Source labels and User-Agent do not establish identity, human presence or consent.","lead_creation":"Preparing or importing a quiz does not create a retailer lead, verify contact ownership, authorize outreach or opt into marketing. Customer review, contact verification and separate retailer-sharing permission are distinct steps."},"sources":["chatgpt","claude","gemini","external_ai_agent","manual_summary","somni_demo"],"aliases":{"setup_mattress":"context.setupMattress","setup_base":"context.setupBase","setup_pillows":"context.setupPillows","setup_bedding":"context.setupBedding","setup_climate":"context.setupClimate","setup_room":"context.setupRoom","sleeper_count":"count","mattress_size":"size","budget_max_usd":"budget","budget_min_usd":"context.budgetMinimum","zip_code":"context.deliveryZip","delivery_zip":"context.deliveryZip","sleep_position":"s1.position","weight_lb":"s1.weight","weight_kg":"s1.weight","height_cm":"s1.heightCm","height_in":"s1.heightCm","firmness_preference":"s1.feel","temperature":"s1.temperature","pressure_frequency":"s1.pressure","discomfort_areas":"s1.discomfort","responsiveness":"s1.responsiveness","motion_sensitivity":"s1.motionSensitivity","edge_importance":"s1.edgeImportance"},"canonicalFields":[{"key":"count","label":"Sleepers","optional":false,"private":false,"options":[["1","Just me"],["2","Two sleepers"]]},{"key":"size","label":"Mattress size","optional":false,"private":false,"options":[["twin","twin"],["twin xl","twin xl"],["full","full"],["queen","queen"],["king","king"],["california king","california king"]]},{"key":"budget","label":"Maximum budget (USD)","optional":false,"private":false},{"key":"s1.name","label":"Name or alias","optional":false,"private":true},{"key":"s1.weightRange","label":"Weight range","optional":false,"private":true,"options":[["50","50–124 lb"],["125","125–174 lb"],["175","175–224 lb"],["225","225–274 lb"],["275","275–324 lb"],["325","325–399 lb"],["400","400–499 lb"],["500","500–700 lb"]]},{"key":"s1.position","label":"Usual position","optional":false,"private":false,"options":[["side","side"],["back","back"],["stomach","stomach"],["combination","combination"]]},{"key":"s1.secondaryPositions","label":"Other positions","optional":true,"private":false},{"key":"s1.feel","label":"Surface feel","optional":false,"private":false,"options":[["firm","firm"],["medium firm","medium firm"],["medium","medium"],["plush","plush"],["unsure","unsure"]]},{"key":"s1.pressure","label":"Pressure frequency","optional":false,"private":false,"options":[["0","Rarely"],["1","Sometimes"],["2","Often"],["3","Most nights"],["null","Prefer not to answer"]]},{"key":"s1.temperature","label":"Temperature","optional":false,"private":false,"options":[["hot","hot"],["neutral","neutral"],["cold","cold"]]},{"key":"s1.responsiveness","label":"Movement preference","optional":false,"private":false,"options":[["contouring","contouring"],["balanced","balanced"],["responsive","responsive"]]},{"key":"s1.edgeImportance","label":"Edge importance","optional":false,"private":false,"options":[["0","Low"],["2","Medium"],["4","High"]]},{"key":"s1.motionSensitivity","label":"Motion sensitivity","optional":false,"private":false,"options":[["0","Rarely"],["2","Sometimes"],["4","Very easily"]]},{"key":"s1.discomfort","label":"Cushioning priorities","optional":false,"private":true,"options":[["Neck","Neck"],["Shoulders","Shoulders"],["Upper back","Upper back"],["Lower back","Lower back"],["Hips","Hips"],["Knees","Knees"]]},{"key":"s1.currentFeel","label":"Current-bed feel to this sleeper","optional":true,"private":true,"options":[["too firm","Too firm"],["comfortable","About right"],["too soft","Too soft"],["unsure","Not sure"]]},{"key":"s1.heightCm","label":"Height (cm)","optional":true,"private":true},{"key":"s1.shoulderWidth","label":"Shoulder width","optional":true,"private":true},{"key":"s1.hipWidth","label":"Hip width","optional":true,"private":true},{"key":"s1.bodyOutline","label":"Midsection shape","optional":true,"private":true},{"key":"s1.turningEase","label":"Ease of turning","optional":true,"private":false,"options":[["easy","Easy to move"],["sometimes","Sometimes feel stuck"],["difficult","Often feel stuck"],["unsure","Not sure"]]},{"key":"s1.heatTiming","label":"When warmth bothers you","optional":true,"private":false,"options":[["falling asleep","While falling asleep"],["overnight","Later in the night"],["both","Both"],["unsure","Not sure"]]},{"key":"s1.pillowComfort","label":"Current pillow feel","optional":true,"private":false,"options":[["too high","Too high"],["too low","Too low"],["comfortable","About right"],["unsure","Not sure"]]},{"key":"s1.priority","label":"Most important improvement","optional":true,"private":false,"options":[["cushioning","Pressure cushioning"],["cooling","Temperature comfort"],["movement","Ease of moving"],["motion","Partner movement"],["edge","A steadier edge"],["unsure","Not sure"]]},{"key":"s2.name","label":"Name or alias","optional":false,"private":true},{"key":"s2.weightRange","label":"Weight range","optional":false,"private":true,"options":[["50","50–124 lb"],["125","125–174 lb"],["175","175–224 lb"],["225","225–274 lb"],["275","275–324 lb"],["325","325–399 lb"],["400","400–499 lb"],["500","500–700 lb"]]},{"key":"s2.position","label":"Usual position","optional":false,"private":false,"options":[["side","side"],["back","back"],["stomach","stomach"],["combination","combination"]]},{"key":"s2.secondaryPositions","label":"Other positions","optional":true,"private":false},{"key":"s2.feel","label":"Surface feel","optional":false,"private":false,"options":[["firm","firm"],["medium firm","medium firm"],["medium","medium"],["plush","plush"],["unsure","unsure"]]},{"key":"s2.pressure","label":"Pressure frequency","optional":false,"private":false,"options":[["0","Rarely"],["1","Sometimes"],["2","Often"],["3","Most nights"],["null","Prefer not to answer"]]},{"key":"s2.temperature","label":"Temperature","optional":false,"private":false,"options":[["hot","hot"],["neutral","neutral"],["cold","cold"]]},{"key":"s2.responsiveness","label":"Movement preference","optional":false,"private":false,"options":[["contouring","contouring"],["balanced","balanced"],["responsive","responsive"]]},{"key":"s2.edgeImportance","label":"Edge importance","optional":false,"private":false,"options":[["0","Low"],["2","Medium"],["4","High"]]},{"key":"s2.motionSensitivity","label":"Motion sensitivity","optional":false,"private":false,"options":[["0","Rarely"],["2","Sometimes"],["4","Very easily"]]},{"key":"s2.discomfort","label":"Cushioning priorities","optional":false,"private":true,"options":[["Neck","Neck"],["Shoulders","Shoulders"],["Upper back","Upper back"],["Lower back","Lower back"],["Hips","Hips"],["Knees","Knees"]]},{"key":"s2.currentFeel","label":"Current-bed feel to this sleeper","optional":true,"private":true,"options":[["too firm","Too firm"],["comfortable","About right"],["too soft","Too soft"],["unsure","Not sure"]]},{"key":"s2.heightCm","label":"Height (cm)","optional":true,"private":true},{"key":"s2.shoulderWidth","label":"Shoulder width","optional":true,"private":true},{"key":"s2.hipWidth","label":"Hip width","optional":true,"private":true},{"key":"s2.bodyOutline","label":"Midsection shape","optional":true,"private":true},{"key":"s2.turningEase","label":"Ease of turning","optional":true,"private":false,"options":[["easy","Easy to move"],["sometimes","Sometimes feel stuck"],["difficult","Often feel stuck"],["unsure","Not sure"]]},{"key":"s2.heatTiming","label":"When warmth bothers you","optional":true,"private":false,"options":[["falling asleep","While falling asleep"],["overnight","Later in the night"],["both","Both"],["unsure","Not sure"]]},{"key":"s2.pillowComfort","label":"Current pillow feel","optional":true,"private":false,"options":[["too high","Too high"],["too low","Too low"],["comfortable","About right"],["unsure","Not sure"]]},{"key":"s2.priority","label":"Most important improvement","optional":true,"private":false,"options":[["cushioning","Pressure cushioning"],["cooling","Temperature comfort"],["movement","Ease of moving"],["motion","Partner movement"],["edge","A steadier edge"],["unsure","Not sure"]]},{"key":"context.accessoryInterests","label":"Sleep setup interests","optional":true,"private":true,"options":[["pillows","Pillows"],["sheets","Sheets"],["protection","Mattress protection"],["climate","Temperature"],["room","Sleep Environment"]]},{"key":"context.budgetMinimum","label":"Starting mattress price (USD)","optional":true,"private":true},{"key":"context.paymentPreferences","label":"Payment interests","optional":true,"private":true,"options":[["monthly","I’d like low monthly payments"],["hsa-fsa","I’d like to use HSA/FSA"]]},{"key":"context.technology","label":"Construction","optional":true,"private":false,"options":[["any","any"],["Memory foam","Memory foam"],["Hybrid","Hybrid"],["Innerspring","Innerspring"],["Specialty","Specialty"]]},{"key":"context.currentProblem","label":"Current mattress","optional":true,"private":false,"options":[["none","none"],["too firm","too firm"],["too soft","too soft"],["sagging","sagging"],["heat","heat"],["motion","motion"],["unsure","unsure"]]},{"key":"context.durabilityPriority","label":"Durability priority","optional":true,"private":true,"options":[["balanced","Balance lasting quality and price"],["priority","Long-term durability is a top priority"],["explore","Help me compare the trade-offs"]]},{"key":"context.baseFeatures","label":"Adjustable base features","optional":true,"private":false,"options":[["head elevation","Raise my head"],["leg elevation","Raise my legs"],["reading","Read or watch TV in bed"],["independent positions","Separate positions for two sleepers"],["easier access","Explore easier bed access"],["massage","Massage / vibration"],["not interested","Not interested"],["unsure","Not sure yet"]]},{"key":"context.timing","label":"Shopping timeline","optional":true,"private":false,"options":[["soon","soon"],["this month","this month"],["exploring","exploring"]]},{"key":"context.setupMattress","label":"Mattress plan","optional":true,"private":true,"options":[["keep","keep"],["replace","replace"],["add","add"],["skip","skip"],["unsure","unsure"]]},{"key":"context.setupBase","label":"Adjustable base plan","optional":true,"private":true,"options":[["keep","keep"],["replace","replace"],["add","add"],["skip","skip"],["unsure","unsure"]]},{"key":"context.setupPillows","label":"Pillows plan","optional":true,"private":true,"options":[["keep","keep"],["replace","replace"],["add","add"],["skip","skip"],["unsure","unsure"]]},{"key":"context.setupBedding","label":"Sheets & mattress protection plan","optional":true,"private":true,"options":[["keep","keep"],["replace","replace"],["add","add"],["skip","skip"],["unsure","unsure"]]},{"key":"context.setupClimate","label":"Temperature comfort plan","optional":true,"private":true,"options":[["keep","keep"],["replace","replace"],["add","add"],["skip","skip"],["unsure","unsure"]]},{"key":"context.setupRoom","label":"Sleep environment plan","optional":true,"private":true,"options":[["keep","keep"],["replace","replace"],["add","add"],["skip","skip"],["unsure","unsure"]]},{"key":"context.beddingConfiguration","label":"Bed configuration","optional":true,"private":true,"options":[["standard","standard"],["split","split"],["split-head","split-head"],["unsure","unsure"]]},{"key":"context.pillowFeel","label":"Pillow feel","optional":true,"private":true,"options":[["adjustable","adjustable"],["responsive","responsive"],["unsure","unsure"]]},{"key":"context.sheetFeel","label":"Sheet feel","optional":true,"private":true,"options":[["smooth","smooth"],["stretch","stretch"],["cotton","cotton"],["unsure","unsure"]]},{"key":"context.materialAvoid","label":"Materials to leave out","optional":true,"private":true},{"key":"context.climateApproach","label":"Temperature approach","optional":true,"private":true,"options":[["bedding","bedding"],["airflow","airflow"],["water","water"],["compare","compare"]]},{"key":"context.climateZones","label":"Temperature zones","optional":true,"private":true,"options":[["shared","shared"],["independent","independent"],["unsure","unsure"]]},{"key":"context.roomNeed","label":"Room environment","optional":true,"private":true,"options":[["light","light"],["sound","sound"],["both","both"],["unsure","unsure"]]},{"key":"context.protectorNeed","label":"Mattress protection","optional":true,"private":true,"options":[["spills","spills"],["encasement","encasement"],["unsure","unsure"]]},{"key":"context.goals","label":"goals","optional":true,"private":false},{"key":"context.mattressStatus","label":"mattressStatus","optional":true,"private":false,"options":[["replace","replace"],["browse","browse"],["keep","keep"]]}],"exactWeightKeys":["s1.weight","s2.weight"],"expiryMinutes":15,"limits":{"answers":60,"bytes":16384},"example":{"schema_version":"1.0","source":"somni_demo","shopper_approved":false,"requested_action":"continue_fit","answers":{"count":1,"s1.name":"Alex","sleep_position":"side","weight_lb":185,"height_cm":178,"budget_max_usd":2000,"mattress_size":"queen","firmness_preference":"plush","zip_code":"80241"},"provenance":{"count":"explicit","s1.name":"explicit","sleep_position":"explicit","weight_lb":"explicit","height_cm":"explicit","budget_max_usd":"explicit","mattress_size":"explicit","firmness_preference":"inferred","zip_code":"explicit"}}}