Submit tracking events and retrieve personalized zone content from the server side.
This endpoint combines event tracking with zone content retrieval in a single request,
making it suitable for server-side rendered applications.
Visitor and session IDs should be persisted as cookies on the end user’s browser:
Map of zone IDs to their personalized content. Each zone contains
content based on the zone type configured in the PureClarity dashboard.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PureClarity","description":"PureClarity is an AI-driven personalization platform that enhances e-commerce experiences through intelligent recommendations and dynamic content.","colors":{"primary":"#1585ff","light":"#4a98ee","dark":"#1585ff"},"logo":{"light":"https://mintcdn.com/pureclarity/XrseGmtERByAl6Lj/logo/light-pc.webp?fit=max\u0026auto=format\u0026n=XrseGmtERByAl6Lj\u0026q=85\u0026s=cc41bee603147eb943fcd0b238072834","dark":"https://mintcdn.com/pureclarity/XrseGmtERByAl6Lj/logo/light-pc.webp?fit=max\u0026auto=format\u0026n=XrseGmtERByAl6Lj\u0026q=85\u0026s=cc41bee603147eb943fcd0b238072834"},"favicon":"https://mintcdn.com/pureclarity/XrseGmtERByAl6Lj/pc-logo.png?fit=max\u0026auto=format\u0026n=XrseGmtERByAl6Lj\u0026q=85\u0026s=593e16cc51bba0c5557a0e315551e2cb","navbar":{"links":[{"href":"mailto:support@pureclarity.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://admin.pureclarity.com"}},"footer":{"socials":{"website":"https://pureclarity.com","linkedin":"https://www.linkedin.com/company/pureclarity"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pureclarity","hasAudioNarration":false,"actualSubdomain":"pureclarity","customDomains":["docs.pureclarity.com"],"gitSource":{"type":"github","owner":"pureclarity","repo":"pureclarity","deployBranch":"dev","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adcb58ba9d4b58550296af1","collectionId":"d415ef73-1df1-4040-ab31-bc4127ffd53c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adcb58ba9d4b58550296af1"},"entitlements":{},"buildId":"6adcba34ed3bac47b4072035","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Documentation","count":262},{"language":"default","tag":"Platform Integrations","count":88},{"language":"default","tag":"Custom","count":43},{"language":"default","tag":"Magento","count":29},{"language":"default","tag":"Magento 2.x","count":26},{"language":"default","tag":"Core Features","count":18},{"language":"default","tag":"Support \u0026 Resources","count":15},{"language":"default","tag":"Data Feeds","count":14},{"language":"default","tag":"General Support","count":12},{"language":"default","tag":"Event Tracking Reference","count":9}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/server-side/server-side-personalization-request","slug":"/api-reference/server-side/server-side-personalization-request","pageMetadata":{"title":"Server-side personalization request","description":"Submit tracking events and retrieve personalized zone content from the server side.\nThis endpoint combines event tracking with zone content retrieval in a single request,\nmaking it suitable for server-side rendered applications.\n\nVisitor and session IDs should be persisted as cookies on the end user's browser:\n- `pc_v_{access_key}` for the visitor ID\n- `pc_sessid_{access_key}` for the session ID\n","deprecated":null,"version":null,"openapi":"/integrations/custom/api-reference/openapi.yaml post /api/serverside","href":"/api-reference/server-side/server-side-personalization-request","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Submit tracking events and retrieve personalized zone content from the server side.\\nThis endpoint combines event tracking with zone content retrieval in a single request,\\nmaking it suitable for server-side rendered applications.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Visitor and session IDs should be persisted as cookies on the end user’s browser:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"pc_v_{access_key}\"\n }), \" for the visitor ID\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"pc_sessid_{access_key}\"\n }), \" for the session ID\"]\n }), \"\\n\"]\n })]\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":"Server-side personalization request","description":"Submit tracking events and retrieve personalized zone content from the server side.\nThis endpoint combines event tracking with zone content retrieval in a single request,\nmaking it suitable for server-side rendered applications.\n\nVisitor and session IDs should be persisted as cookies on the end user's browser:\n- `pc_v_{access_key}` for the visitor ID\n- `pc_sessid_{access_key}` for the session ID\n","deprecated":null,"version":null,"openapi":"/integrations/custom/api-reference/openapi.yaml post /api/serverside","href":"/api-reference/server-side/server-side-personalization-request","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"serverSideRequest","summary":"Server-side personalization request","description":"Submit tracking events and retrieve personalized zone content from the server side.\nThis endpoint combines event tracking with zone content retrieval in a single request,\nmaking it suitable for server-side rendered applications.\n\nVisitor and session IDs should be persisted as cookies on the end user's browser:\n- `pc_v_{access_key}` for the visitor ID\n- `pc_sessid_{access_key}` for the session ID\n","tags":["Server-side"],"requestBody":"fa058809-ba35-40cd-954d-3039a994c27e","responses":{"200":"9863c398-93d3-497e-a3ee-b05b4cd6668e","400":"b2cc5c46-0a8c-451c-80be-f870808ea7fb","403":"7fe4ac06-db28-4aa8-bd91-0452d5d37b3c"},"method":"post","type":"path","servers":["f9796329-0028-46d0-a842-f1ecd9b1c059","3de660b6-b8dd-4c67-806d-8e65c52b2cf0"],"security":[],"path":"/api/serverside","baseUrlOptions":["https://api-eu-w-1.pureclarity.net","https://api-us-e-1.pureclarity.net"],"title":"Server-side personalization request","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["appId","secretKey","currentUrl","userAgent","ip"],"properties":{"appId":{"type":"string","description":"Your store's unique access key","isRequired":true,"uniqueKey":"appId","typeLabel":"string"},"secretKey":{"type":"string","description":"Your store's secret key for server-side authentication","isRequired":true,"uniqueKey":"secretKey","typeLabel":"string"},"currentUrl":{"type":"string","format":"uri","description":"The full URL of the page being rendered","isRequired":true,"uniqueKey":"currentUrl","typeLabel":"string\u003curi>"},"userAgent":{"type":"string","description":"The end user's browser user agent string","isRequired":true,"uniqueKey":"userAgent","typeLabel":"string"},"ip":{"type":"string","description":"The end user's IP address","isRequired":true,"uniqueKey":"ip","typeLabel":"string"},"visitorId":{"type":"string","description":"Persistent visitor identifier. If omitted, a new one is generated and returned in the response.","uniqueKey":"visitorId","typeLabel":"string"},"sessionId":{"type":"string","description":"Session identifier. If omitted, a new one is generated and returned in the response.","uniqueKey":"sessionId","typeLabel":"string"},"referer":{"type":"string","description":"The HTTP referer header value from the end user's request","uniqueKey":"referer","typeLabel":"string"},"currency":{"type":"string","description":"ISO 4217 currency code (e.g. GBP, USD, EUR)","example":"GBP","uniqueKey":"currency","typeLabel":"string"},"events":{"type":"array","description":"Array of tracking events to record","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"The event type name. Supported event types:\n- `page_view` - Page view tracking\n- `product_view` - Product page view\n- `product_rate` - Product rating\n- `set_basket` - Update basket contents\n- `order` - Order completion\n- `customer_details` - Customer identification\n","enum":["page_view","product_view","product_rate","set_basket","order","customer_details"],"isRequired":true,"uniqueKey":"events.items.[INDEX].name","typeLabel":"enum\u003cstring>"},"data":{"oneOf":[{"type":"object","description":"Event-specific data. Structure varies by event type.","required":["page_type"],"properties":{"page_type":{"type":"string","description":"The type of page being viewed","enum":["homepage","search_results","category_listing_page","product_page","basket_page","order_complete_page","other"],"isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.0.page_type","typeLabel":"enum\u003cstring>"},"product_id":{"type":"string","description":"Product ID when on a product page","uniqueKey":"events.items.[INDEX].data.oneOf.0.product_id","typeLabel":"string"},"category_id":{"type":"string","description":"Category ID when on a category listing page","uniqueKey":"events.items.[INDEX].data.oneOf.0.category_id","typeLabel":"string"},"brand_id":{"type":"string","description":"Brand ID when on a brand page","uniqueKey":"events.items.[INDEX].data.oneOf.0.brand_id","typeLabel":"string"}},"uniqueKey":"events.items.[INDEX].data.oneOf.0","typeLabel":"object"},{"type":"object","description":"Event-specific data. Structure varies by event type.","required":["id"],"properties":{"id":{"type":"string","description":"The unique product ID","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.1.id","typeLabel":"string"}},"uniqueKey":"events.items.[INDEX].data.oneOf.1","typeLabel":"object"},{"type":"object","description":"Event-specific data. Structure varies by event type.","required":["id","rating"],"properties":{"id":{"type":"string","description":"The unique product ID","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.2.id","typeLabel":"string"},"rating":{"type":"number","description":"The rating value","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.2.rating","typeLabel":"number"}},"uniqueKey":"events.items.[INDEX].data.oneOf.2","typeLabel":"object"},{"type":"object","description":"Event-specific data. Structure varies by event type.","properties":{"items":{"type":"array","items":{"type":"object","required":["id","qty","unitprice"],"properties":{"id":{"type":"string","description":"Product ID","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.3.\\items.items.[INDEX].id","typeLabel":"string"},"qty":{"type":"number","description":"Quantity in the basket","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.3.\\items.items.[INDEX].qty","typeLabel":"number"},"unitprice":{"type":"number","description":"Unit price (use `.` as decimal separator)","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.3.\\items.items.[INDEX].unitprice","typeLabel":"number"}},"uniqueKey":"events.items.[INDEX].data.oneOf.3.\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"events.items.[INDEX].data.oneOf.3.\\items","typeLabel":"object[]"}},"uniqueKey":"events.items.[INDEX].data.oneOf.3","typeLabel":"object"},{"type":"object","description":"Event-specific data. Structure varies by event type.","required":["orderid","items"],"properties":{"orderid":{"type":"string","description":"Unique order identifier. Each order ID should only be sent once.","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.4.orderid","typeLabel":"string"},"items":{"type":"array","description":"Order line items","items":{"type":"object","required":["id","qty","unitprice"],"properties":{"id":{"type":"string","description":"Product ID","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.4.\\items.items.[INDEX].id","typeLabel":"string"},"qty":{"type":"number","description":"Quantity in the basket","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.4.\\items.items.[INDEX].qty","typeLabel":"number"},"unitprice":{"type":"number","description":"Unit price (use `.` as decimal separator)","isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.4.\\items.items.[INDEX].unitprice","typeLabel":"number"}},"uniqueKey":"events.items.[INDEX].data.oneOf.4.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"events.items.[INDEX].data.oneOf.4.\\items","typeLabel":"object[]"},"ordertotal":{"type":"number","description":"Total order value in base currency","uniqueKey":"events.items.[INDEX].data.oneOf.4.ordertotal","typeLabel":"number"},"userid":{"type":"string","description":"Unique user identifier","uniqueKey":"events.items.[INDEX].data.oneOf.4.userid","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Customer email address","uniqueKey":"events.items.[INDEX].data.oneOf.4.email","typeLabel":"string\u003cemail>"},"accid":{"type":"string","description":"B2B account identifier","uniqueKey":"events.items.[INDEX].data.oneOf.4.accid","typeLabel":"string"},"groupid":{"type":"string","description":"User group for price banding","uniqueKey":"events.items.[INDEX].data.oneOf.4.groupid","typeLabel":"string"},"title":{"type":"string","description":"Customer title (e.g. Mr, Mrs)","uniqueKey":"events.items.[INDEX].data.oneOf.4.title","typeLabel":"string"},"firstname":{"type":"string","description":"Customer first name","uniqueKey":"events.items.[INDEX].data.oneOf.4.firstname","typeLabel":"string"},"lastname":{"type":"string","description":"Customer last name","uniqueKey":"events.items.[INDEX].data.oneOf.4.lastname","typeLabel":"string"},"zipcode":{"type":"string","description":"Delivery zip/postal code","uniqueKey":"events.items.[INDEX].data.oneOf.4.zipcode","typeLabel":"string"},"postcode":{"type":"string","description":"Delivery postal code (alias for zipcode)","uniqueKey":"events.items.[INDEX].data.oneOf.4.postcode","typeLabel":"string"},"dob":{"type":"string","description":"Date of birth in YYYY-MM-DD format","example":"1990-01-15","uniqueKey":"events.items.[INDEX].data.oneOf.4.dob","typeLabel":"string"}},"uniqueKey":"events.items.[INDEX].data.oneOf.4","typeLabel":"object"},{"type":"object","description":"Event-specific data. Structure varies by event type.","properties":{"userid":{"type":"string","description":"Unique user identifier","uniqueKey":"events.items.[INDEX].data.oneOf.5.userid","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Customer email address","uniqueKey":"events.items.[INDEX].data.oneOf.5.email","typeLabel":"string\u003cemail>"},"accid":{"type":"string","description":"B2B account identifier","uniqueKey":"events.items.[INDEX].data.oneOf.5.accid","typeLabel":"string"},"firstname":{"type":"string","description":"Customer first name","uniqueKey":"events.items.[INDEX].data.oneOf.5.firstname","typeLabel":"string"},"lastname":{"type":"string","description":"Customer last name","uniqueKey":"events.items.[INDEX].data.oneOf.5.lastname","typeLabel":"string"},"title":{"type":"string","description":"Customer title (e.g. Mr, Mrs)","uniqueKey":"events.items.[INDEX].data.oneOf.5.title","typeLabel":"string"},"group_id":{"type":"string","description":"User group identifier","uniqueKey":"events.items.[INDEX].data.oneOf.5.group_id","typeLabel":"string"}},"uniqueKey":"events.items.[INDEX].data.oneOf.5","typeLabel":"object"}],"uniqueKey":"events.items.[INDEX].data","typeLabel":"object"}},"uniqueKey":"events.items.[INDEX]","typeLabel":"object"},"uniqueKey":"events","typeLabel":"object[]"},"zones":{"type":"array","description":"Array of zone IDs to retrieve personalized content for","items":{"type":"string","uniqueKey":"zones.items.[INDEX]","typeLabel":"string"},"example":["HP-01","PP-01"],"uniqueKey":"zones","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"appId":"your-access-key","secretKey":"your-secret-key","currentUrl":"https://www.example.com/products/shoes","userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64)","ip":"203.0.113.50","currency":"GBP","events":[{"name":"page_view","data":{"page_type":"product_page"}},{"name":"product_view","data":{"id":"PROD-001"}}],"zones":["HP-01","PP-01"]},"examples":{"Example":{"title":"Example","value":{"appId":"your-access-key","secretKey":"your-secret-key","currentUrl":"https://www.example.com/products/shoes","userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64)","ip":"203.0.113.50","currency":"GBP","events":[{"name":"page_view","data":{"page_type":"product_page"}},{"name":"product_view","data":{"id":"PROD-001"}}],"zones":["HP-01","PP-01"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"9863c398-93d3-497e-a3ee-b05b4cd6668e":{"description":"Successful response with personalized zone content","content":{"application/json":{"schema":{"type":"object","properties":{"visitorId":{"type":"string","description":"Visitor identifier. Store as a persistent cookie named `pc_v_{access_key}`\non the end user's browser.\n","uniqueKey":"visitorId","typeLabel":"string"},"sessionId":{"type":"string","description":"Session identifier. Store as a session cookie named `pc_sessid_{access_key}`\non the end user's browser.\n","uniqueKey":"sessionId","typeLabel":"string"},"errors":{"type":"array","description":"Array of error messages, if any","items":{"type":"string","uniqueKey":"errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors","typeLabel":"string[]"},"zones":{"type":"object","description":"Map of zone IDs to their personalized content. Each zone contains\ncontent based on the zone type configured in the PureClarity dashboard.\n","additionalProperties":{"type":"object","description":"Personalized content for a single zone","properties":{"title":{"type":"string","description":"Display title for the zone","uniqueKey":"zones.additionalProperties.title","typeLabel":"string"},"type":{"type":"string","description":"The content type of the zone","enum":["recommender-product","recommender-category","recommender-brand","image-carousel","image","html"],"uniqueKey":"zones.additionalProperties.type","typeLabel":"enum\u003cstring>"},"items":{"type":"array","description":"Array of items for recommender zones","items":{"type":"object","description":"A product item returned in a recommender zone","properties":{"Id":{"type":"string","description":"Product ID","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Id","typeLabel":"string"},"Sku":{"type":"string","description":"Product SKU","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Sku","typeLabel":"string"},"Title":{"type":"string","description":"Product title","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Title","typeLabel":"string"},"Description":{"type":"string","description":"Product description","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Description","typeLabel":"string"},"Link":{"type":"string","description":"Product page URL","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Link","typeLabel":"string"},"Image":{"type":"string","description":"Product image URL","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Image","typeLabel":"string"},"ImageOverlay":{"type":"string","description":"Overlay image URL","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].ImageOverlay","typeLabel":"string"},"AllImages":{"type":"array","description":"All product images","items":{"type":"string","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].AllImages.items.[INDEX]","typeLabel":"string"},"uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].AllImages","typeLabel":"string[]"},"Price":{"type":"number","description":"Current price","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Price","typeLabel":"number"},"WasPrice":{"type":"number","description":"Original price before discount","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].WasPrice","typeLabel":"number"},"SavingPrice":{"type":"number","description":"Amount saved","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].SavingPrice","typeLabel":"number"},"DisplayPrice":{"type":"string","description":"Formatted display price with currency symbol","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].DisplayPrice","typeLabel":"string"},"DisplayWasPrice":{"type":"string","description":"Formatted original price","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].DisplayWasPrice","typeLabel":"string"},"SavingDisplayPrice":{"type":"string","description":"Formatted saving amount","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].SavingDisplayPrice","typeLabel":"string"},"CurrencySymbol":{"type":"string","description":"Currency symbol","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].CurrencySymbol","typeLabel":"string"},"SavingPercent":{"type":"string","description":"Percentage saving","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].SavingPercent","typeLabel":"string"},"Categories":{"type":"array","description":"Product category IDs","items":{"type":"string","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Categories.items.[INDEX]","typeLabel":"string"},"uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Categories","typeLabel":"string[]"},"Brand":{"type":"object","description":"Brand information","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].Brand","typeLabel":"object"},"SearchTags":{"type":"array","description":"Product search tags","items":{"type":"string","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].SearchTags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].SearchTags","typeLabel":"string[]"},"OnOffer":{"type":"boolean","description":"Whether the product is on offer","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].OnOffer","typeLabel":"boolean"},"NewArrival":{"type":"boolean","description":"Whether the product is a new arrival","uniqueKey":"zones.additionalProperties.\\items.items.[INDEX].NewArrival","typeLabel":"boolean"}},"uniqueKey":"zones.additionalProperties.\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"zones.additionalProperties.\\items","typeLabel":"object[]"},"html":{"type":"string","description":"Pre-rendered HTML content (for html zone type)","uniqueKey":"zones.additionalProperties.html","typeLabel":"string"}},"uniqueKey":"zones.additionalProperties","typeLabel":"object"},"uniqueKey":"zones","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"visitorId":"abc123-visitor-id","sessionId":"xyz789-session-id","zones":{"HP-01":{"title":"Recommended for you","type":"recommender-product","items":[{"Id":"PROD-001","Title":"Running Shoes","Price":59.99,"Link":"/products/running-shoes","Image":"https://cdn.example.com/shoes.jpg"}]}}},"examples":{"Example":{"title":"Example","value":{"visitorId":"abc123-visitor-id","sessionId":"xyz789-session-id","zones":{"HP-01":{"title":"Recommended for you","type":"recommender-product","items":[{"Id":"PROD-001","Title":"Running Shoes","Price":59.99,"Link":"/products/running-shoes","Image":"https://cdn.example.com/shoes.jpg"}]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"b2cc5c46-0a8c-451c-80be-f870808ea7fb":{"description":"Validation error (e.g. missing required fields)","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","description":"Array of error messages","items":{"type":"string","uniqueKey":"errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"7fe4ac06-db28-4aa8-bd91-0452d5d37b3c":{"description":"Invalid or unrecognised access key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","description":"Array of error messages","items":{"type":"string","uniqueKey":"errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"f9796329-0028-46d0-a842-f1ecd9b1c059":{"url":"https://api-eu-w-1.pureclarity.net","description":"EU Region (Ireland)"},"3de660b6-b8dd-4c67-806d-8e65c52b2cf0":{"url":"https://api-us-e-1.pureclarity.net","description":"US Region (Virginia)"}}},"originalFileLocation":"integrations/custom/api-reference/openapi.yaml"},"subdomain":"pureclarity","siteName":"PureClarity","title":"Server-side personalization request - PureClarity","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-23T13:09:42.051Z","originalFileLocation":"api-reference/server-side/server-side-personalization-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=\"Submit tracking events and retrieve personalized zone content from the server side. This endpoint combines event tracking with zone content retrieval in a single request, making it suitable for server-side rendered applications. Visitor and session IDs should be persisted as cookies on the end user\u0026#x27;s browser: - pc_v_{access_key} for the visitor ID - pc_sessid_{access_key} for the session ID\">\u003cmeta data-mint-head name=\"application-name\" content=\"PureClarity\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pureclarity/5zm4q6jQFMTsDw9J/_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/pureclarity/5zm4q6jQFMTsDw9J/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pureclarity/5zm4q6jQFMTsDw9J/_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/pureclarity/5zm4q6jQFMTsDw9J/_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/pureclarity/5zm4q6jQFMTsDw9J/_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/pureclarity/5zm4q6jQFMTsDw9J/_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/pureclarity/5zm4q6jQFMTsDw9J/_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/pureclarity/5zm4q6jQFMTsDw9J/_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/pureclarity/5zm4q6jQFMTsDw9J/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Server-side personalization request - PureClarity\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submit tracking events and retrieve personalized zone content from the server side. This endpoint combines event tracking with zone content retrieval in a single request, making it suitable for server-side rendered applications. Visitor and session IDs should be persisted as cookies on the end user\u0026#x27;s browser: - pc_v_{access_key} for the visitor ID - pc_sessid_{access_key} for the session ID\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PureClarity\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-request\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pureclarity.mintlify.app/_mintlify/api/og/v2?division=Server-side\u0026amp;title=Server-side+personalization+request\u0026amp;description=Submit+tracking+events+and+retrieve+personalized+zone+content+from+the+server+side.%0AThis+endpoint+combines+event+tracking+with+zone+content+retrieval+in+a+singl\u0026amp;theme=18e04ecd5f2b83d109226855\u0026amp;signature=a97afe7fc98d5c69fac7a08746d8a1b898135b3cdc69bde358154ac38614e7ea\">\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=\"Server-side personalization request - PureClarity\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submit tracking events and retrieve personalized zone content from the server side. This endpoint combines event tracking with zone content retrieval in a single request, making it suitable for server-side rendered applications. Visitor and session IDs should be persisted as cookies on the end user\u0026#x27;s browser: - pc_v_{access_key} for the visitor ID - pc_sessid_{access_key} for the session ID\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pureclarity.mintlify.app/_mintlify/api/og/v2?division=Server-side\u0026amp;title=Server-side+personalization+request\u0026amp;description=Submit+tracking+events+and+retrieve+personalized+zone+content+from+the+server+side.%0AThis+endpoint+combines+event+tracking+with+zone+content+retrieval+in+a+singl\u0026amp;theme=18e04ecd5f2b83d109226855\u0026amp;signature=a97afe7fc98d5c69fac7a08746d8a1b898135b3cdc69bde358154ac38614e7ea\">\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/pureclarity/5zm4q6jQFMTsDw9J/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PureClarity\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1585ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-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/server-side/server-side-personalization-request.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pureclarity.com/#organization\",\"name\":\"PureClarity\",\"url\":\"https://docs.pureclarity.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pureclarity/XrseGmtERByAl6Lj/logo/light-pc.webp?fit=max\u0026auto=format\u0026n=XrseGmtERByAl6Lj\u0026q=85\u0026s=cc41bee603147eb943fcd0b238072834\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pureclarity.com#website\",\"name\":\"PureClarity\",\"url\":\"https://docs.pureclarity.com\",\"publisher\":{\"@id\":\"https://docs.pureclarity.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-request#webpage\",\"url\":\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-request\",\"name\":\"Server-side personalization request\",\"description\":\"Submit tracking events and retrieve personalized zone content from the server side. This endpoint combines event tracking with zone content retrieval in a single request, making it suitable for server-side rendered applications. Visitor and session IDs should be persisted as cookies on the end user's browser: - pc_v_{access_key} for the visitor ID - pc_sessid_{access_key} for the session ID\",\"dateModified\":\"2026-02-23T13:09:42.051Z\",\"isPartOf\":{\"@id\":\"https://docs.pureclarity.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-request#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-request#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"PureClarity\",\"item\":\"https://docs.pureclarity.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Server-side personalization request\",\"item\":\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-request\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-request#apireference\",\"headline\":\"Server-side personalization request\",\"name\":\"Server-side personalization request\",\"description\":\"Submit tracking events and retrieve personalized zone content from the server side. This endpoint combines event tracking with zone content retrieval in a single request, making it suitable for server-side rendered applications. Visitor and session IDs should be persisted as cookies on the end user's browser: - pc_v_{access_key} for the visitor ID - pc_sessid_{access_key} for the session ID\",\"url\":\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-request\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pureclarity.com/api-reference/server-side/server-side-personalization-request#webpage\"},\"dateModified\":\"2026-02-23T13:09:42.051Z\",\"publisher\":{\"@id\":\"https://docs.pureclarity.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pureclarity.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PureClarity\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PureClarity","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Server-side","pages":[{"title":"Server-side personalization request","deprecated":null,"version":null,"openapi":"/integrations/custom/api-reference/openapi.yaml post /api/serverside","href":"/api-reference/server-side/server-side-personalization-request"}]},{"group":"Data Feeds","pages":[{"title":"Submit a product feed URL","description":"Submit a URL where PureClarity can download a full JSON product feed.\nThe feed is processed asynchronously, so the URL must remain accessible\nfor at least 24 hours after submission.\n","deprecated":null,"version":null,"openapi":"/integrations/custom/api-reference/openapi.yaml post /api/productfeed","href":"/api-reference/data-feeds/submit-a-product-feed-url"},{"title":"Submit a product delta update","deprecated":null,"version":null,"openapi":"/integrations/custom/api-reference/openapi.yaml post /api/delta","href":"/api-reference/data-feeds/submit-a-product-delta-update"},{"title":"Check delta processing status","deprecated":null,"version":null,"openapi":"/integrations/custom/api-reference/openapi.yaml post /api/deltastatus","href":"/api-reference/data-feeds/check-delta-processing-status"},{"title":"Check product feed processing status","deprecated":null,"version":null,"openapi":"/integrations/custom/api-reference/openapi.yaml post /api/productfeedstatus","href":"/api-reference/data-feeds/check-product-feed-processing-status"}]},{"group":"GDPR","pages":[{"title":"Forget a user (GDPR)","deprecated":null,"version":null,"openapi":"/integrations/custom/api-reference/openapi.yaml post /api/user/forget","href":"/api-reference/gdpr/forget-a-user-gdpr"}]}]},{"tab":"Product Updates","pages":[{"title":"Product Updates","href":"/product-updates"}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/support/general/what-is-pureclarity"}]}]},"title":"Server-side personalization request - PureClarity","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}