This API reference includes Spree Store APIs, which are REST APIs exposed by the Spree application. They are used to create a storefront for your commerce store, such as a website, point of sale or a commerce mobile app.All API Routes are prefixed with /api/v3/store. So, during development, the API Routes will be available under the path http://localhost:3000/api/v3/store. For production, replace http://localhost:3000 with your Spree application URL.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Spree Commerce documentation","colors":{"primary":"#0077ff","light":"#4d9fff","dark":"#0060ce"},"logo":{"light":"https://mintcdn.com/spreecommerce/LxcAXa2TB_svesfi/logo/logo_light.png?fit=max\u0026auto=format\u0026n=LxcAXa2TB_svesfi\u0026q=85\u0026s=fccc5873d5c7a3eeb4e644f96d694ba9","dark":"https://mintcdn.com/spreecommerce/LxcAXa2TB_svesfi/logo/logo_dark.png?fit=max\u0026auto=format\u0026n=LxcAXa2TB_svesfi\u0026q=85\u0026s=3aeefb84d53af450ad04b7283e4d661b"},"favicon":"https://mintcdn.com/spreecommerce/OgdQHBPQ0RbaKyDN/favicon.png?fit=max\u0026auto=format\u0026n=OgdQHBPQ0RbaKyDN\u0026q=85\u0026s=dc14ac5e60560349252428b1dde69c74","api":{"openapi":["api-reference/store.yaml","api-reference/storefront.yaml","api-reference/platform.yaml"],"examples":{"languages":["javascript","curl"]},"mdx":{"server":["http://localhost:3000"]}},"navbar":{"links":[{"icon":{"name":"github","library":"lucide"},"href":"https://github.com/spree/spree","label":"16k"},{"icon":{"name":"discord","library":"lucide"},"href":"https://discord.spreecommerce.org","label":"Join Discord"}]},"footer":{"socials":{"github":"https://github.com/spree/spree","x":"https://x.com/spreecommerce"}},"seo":{"metatags":{"og:locale":"en_US","twitter:site":"@spreecommerce"}},"fonts":{"heading":{"family":"Geist"},"body":{"family":"Geist"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":"night-owl"},"latex":true},"integrations":{"ga4":{"measurementId":"G-NCVLCVHL5Y"}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spreecommerce","hasAudioNarration":false,"actualSubdomain":"spreecommerce","customDomains":["spreecommerce.org"],"gitSource":{"type":"github","owner":"spree","repo":"spree","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adfbbe8e55c0c9c0ccda2a6","collectionId":"609e6f33-0e32-4480-b257-6ef8b8e4ddf2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adfbbe8e55c0c9c0ccda2a6"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adfbbe8e55c0c9c0ccda2a6","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":1119},{"language":"default","tag":"Endpoints","count":784},{"language":"default","tag":"Admin API","count":544},{"language":"default","tag":"Legacy API v2","count":313},{"language":"default","tag":"Platform API","count":231},{"language":"default","tag":"Documentation","count":171},{"language":"default","tag":"Develop","count":171},{"language":"default","tag":"User Guide","count":153},{"language":"default","tag":"Seller API","count":138},{"language":"default","tag":"Store API","count":129}]},"assistantConfig":{"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"deflection":{"enabled":true,"email":"hello@spreecommerce.org","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--spree-accent:#0077ff;--spree-accent-strong:#0060ce;--spree-sand-50:#fcfaf7;--spree-sand-100:#f7f5f2;--spree-sand-150:#e9e5dd;--spree-sand-200:#e2dfd8;--spree-dark-sand-500:#32302e;--spree-dark-sand-600:#272626;--spree-dark-sand-700:#1e1c1b;--spree-dark-sand-800:#191818;--spree-neutral-100:#eaeaea;--spree-neutral-200:#d5d5d5;--spree-neutral-400:#999999;--spree-neutral-600:#666666;--spree-neutral-700:#4d4d4d;--spree-neutral-900:#1a1a1a;--spree-ink:#1a1a1a;--spree-heading:#061932;--spree-ink-muted:#666666;--spree-border:#e2dfd8;--spree-sidebar-hover:rgb(0 0 0 / 0.04);--spree-sidebar-active:rgb(0 0 0 / 0.06);--spree-sidebar-radius:0.625rem;--spree-guide:#d8d4cb}.dark{--spree-sidebar-hover:rgb(255 255 255 / 0.06);--spree-sidebar-active:rgb(255 255 255 / 0.10);--spree-border:#3f3e3c;--spree-guide:#3f3e3c}html:not(.dark) body{background:var(--spree-sand-50)}html.dark body{background:var(--spree-dark-sand-800)}html:not(.dark) h1,html:not(.dark) h2,html:not(.dark) h3,html:not(.dark) h4{color:var(--spree-heading)}.nav-logo{height:32px}#sidebar-content .sidebar-group-header{display:none}#sidebar-content a,#sidebar-content button:not([class*=\"group/search\"]){border-radius:var(--spree-sidebar-radius)!important;padding-top:.3125rem!important;padding-bottom:.3125rem!important}#sidebar-content ul.sidebar-group>li>a,#sidebar-content ul.sidebar-group>li>button{font-weight:500;padding-top:.5rem!important;padding-bottom:.5rem!important}#sidebar-content ul.sidebar-group>li+li{margin-top:.25rem}#sidebar-content li[data-group-tag]>ul{margin-top:.125rem;margin-bottom:.375rem;position:relative}#sidebar-content a:hover,#sidebar-content button:not([class*=\"group/search\"]):hover{background-color:var(--spree-sidebar-hover)!important}#sidebar-content li[data-group-tag][data-active=true]>a,#sidebar-content li[data-group-tag][data-active=true]>button{background-color:var(--spree-sidebar-active)!important;color:var(--spree-neutral-900)!important;font-weight:600!important}.dark #sidebar-content a[class*=\"bg-primary-light/10\"],.dark #sidebar-content a[class*=\"bg-primary/10\"],.dark #sidebar-content li[data-group-tag][data-active=true]>a,.dark #sidebar-content li[data-group-tag][data-active=true]>button{color:#fff!important}#sidebar-content a[class*=\"bg-primary-light/10\"],#sidebar-content a[class*=\"bg-primary/10\"]{background-color:transparent!important;color:var(--spree-neutral-900)!important;font-weight:600!important;text-shadow:none!important}#sidebar-content a[class*=\"bg-primary-light/10\"]:hover,#sidebar-content a[class*=\"bg-primary/10\"]:hover{background-color:var(--spree-sidebar-hover)!important}#sidebar-content ul:not(.sidebar-group)>li>a,#sidebar-content ul:not(.sidebar-group)>li>button{padding-left:.5rem!important;margin-left:2.25rem;margin-right:.25rem;width:calc(100% - 2.5rem)!important}#sidebar-content ul:not(.sidebar-group) ul:not(.sidebar-group)>li>a,#sidebar-content ul:not(.sidebar-group) ul:not(.sidebar-group)>li>button{padding-left:.5rem!important;margin-left:3.75rem;width:calc(100% - 4rem)!important}#sidebar-content li[data-group-tag]>ul::before{content:\"\";position:absolute;left:1.75rem;top:0;bottom:0;width:1px;background-color:var(--spree-guide)}#sidebar-content li[data-group-tag] li[data-group-tag]>ul::before{left:3.25rem}#sidebar-content a svg[class*=bg-gray-],#sidebar-content button svg[class*=bg-gray-]{background-color:currentColor!important;opacity:.6}#sidebar-content a:hover svg[class*=bg-gray-],#sidebar-content button:hover svg[class*=bg-gray-],#sidebar-content li[data-group-tag][data-active=true]>button svg[class*=bg-gray-]{opacity:1}#content-container{border-color:var(--spree-border)!important}.dark #content-container{border-color:#3f3e3c!important}@media (min-width:1024px){#content-container{padding-left:3rem!important;padding-right:3rem!important}#content-container>.flex.flex-row-reverse{padding-left:0!important;column-gap:2.5rem!important}}#content-container .flex.flex-row-reverse>.max-w-xl{max-width:52rem}#almond-background-color{background-color:transparent!important}#navbar{background-color:var(--spree-sand-50)}.dark #navbar{background-color:var(--spree-dark-sand-800)}#navbar.is-custom{border-bottom:1px solid var(--spree-border)}.dark #navbar.is-custom{border-bottom-color:#3f3e3c}#navbar>.absolute.inset-0{display:none}.home-band{background:#fff}.dark .home-band{background:var(--spree-dark-sand-700)}.home-band-end{border-bottom:1px solid rgb(233 229 221/.8)}.dark .home-band-end{border-bottom-color:#3f3e3c}#content-container .link{border-bottom:0!important;color:var(--spree-accent)!important;text-decoration:none!important}#content-container .link:hover{color:var(--spree-accent-strong)!important}.dark #content-container .link{color:#4d9fff!important}.dark #content-container .link:hover{color:#7fb8ff!important}:has(>.changelog-header){max-width:56rem;margin:0 auto;padding:4rem 1.25rem 6rem}.changelog-header h1{font-size:2.25rem;font-weight:600;letter-spacing:-.02em;margin-bottom:.75rem}.changelog-header>[data-as=p],.changelog-header>p{color:var(--spree-ink-muted);font-size:1.0625rem;margin-bottom:1.25rem}.changelog-header .changelog-rss{display:inline-flex;align-items:center;gap:.5rem;margin-bottom:3.5rem;padding:.375rem .875rem;border:1px solid var(--spree-border);border-radius:9999px;font-size:.875rem;font-weight:500;text-decoration:none}.changelog-header .changelog-rss:hover{border-color:var(--spree-accent)}:has(>.changelog-header) [data-as=p],:has(>.changelog-header) p{display:block!important;margin:0 0 1rem;line-height:1.7}:has(>.changelog-header) ul{list-style:disc;padding-left:1.25rem;margin:0 0 1rem}:has(>.changelog-header) li{margin:.25rem 0;line-height:1.65}:has(>.changelog-header) li::marker{color:var(--spree-neutral-400)}:has(>.changelog-header) a{color:var(--spree-accent)}:has(>.changelog-header) a:hover{color:var(--spree-accent-strong)}.dark :has(>.changelog-header) a{color:#4d9fff}table{border:1px solid #d0d7de!important;border-radius:.5rem!important;border-collapse:separate!important;border-spacing:0!important;overflow:hidden!important;width:100%}table thead{background-color:#f3f4f6!important}table th{font-weight:500!important;text-align:left;color:#4b5563!important;padding:.625rem .875rem!important;border-bottom:1px solid #d0d7de!important}table td+td,table th+th{border-left:1px solid #e8ebee!important}table td{padding:.75rem .875rem!important;border-bottom:1px solid #e8ebee!important;vertical-align:middle}table tbody tr:last-child td{border-bottom:0!important}.dark table{border-color:#3d444d!important}.dark table thead{background-color:#21262d!important}.dark table th{color:#9198a1!important;border-bottom-color:#3d444d!important}.dark table td+td,.dark table th+th{border-left-color:#2a3038!important}.dark table td{border-bottom-color:#2a3038!important}"}],"page":{"pagePath":"api-reference/store-api/introduction","slug":"/api-reference/store-api/introduction","pageMetadata":{"title":"Store API","sidebarTitle":"Introduction","description":null,"href":"/api-reference/store-api/introduction"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const Since=({version,from})=>{const{Badge,Tooltip}=_provideComponents()||{};if(!Badge)_missingMdxReference(`Badge`,true);if(!Tooltip)_missingMdxReference(`Tooltip`,true);const knownPrevious={\"5.0\":`4.10`,\"6.0\":`5.4`};const previous=from??knownPrevious[version]??(()=>{const[major,minor]=version.split(`.`).map(Number);if(Number.isNaN(major)||Number.isNaN(minor)||minor\u003c1){throw new Error(`\u003cSince version=\"${version}\" />: cannot derive previous version automatically. `+`Pass an explicit \"from\" prop, e.g. \u003cSince version=\"${version}\" from=\"X.Y\" />.`)}return`${major}.${minor-1}`})();return _jsx(Tooltip,{tip:`Available since Spree ${version}+.`,cta:`Upgrade instructions`,href:`/developer/upgrades/${previous}-to-${version}`,children:_jsxs(Badge,{icon:`lock`,children:[`Spree `,version,`+`]})})};function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,_MdxComponentBoundary}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsx(_MdxComponentBoundary,{name:`Since`,children:_jsx(Since,{version:`5.4`})}),`\n`,_jsx(_components.p,{children:`This API reference includes Spree Store APIs, which are REST APIs exposed by the Spree application. They are used to create a storefront for your commerce store, such as a website, point of sale or a commerce mobile app.`}),`\n`,_jsxs(_components.p,{children:[`All API Routes are prefixed with `,_jsx(_components.code,{children:`/api/v3/store`}),`. So, during development, the API Routes will be available under the path `,_jsx(_components.code,{children:`http://localhost:3000/api/v3/store`}),`. For production, replace `,_jsx(_components.code,{children:`http://localhost:3000`}),` with your Spree application URL.`]}),`\n`,_jsx(Heading,{level:`2`,id:`using-sdk`,children:`Using SDK`}),`\n`,_jsx(_components.p,{children:`We recommend using the Spree SDK to interact with the Store API. The SDK provides a convenient way to make API requests and handle responses.`}),`\n`,_jsx(Heading,{level:`3`,id:`installation`,children:`Installation`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes night-owl night-owl`,style:{backgroundColor:`#011627`,\"--shiki-dark-bg\":`#011627`,color:`#d6deeb`,\"--shiki-dark\":`#d6deeb`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#82AAFF`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#82AAFF`,\"--shiki-dark-font-style\":`italic`},children:`npm`}),_jsx(_components.span,{style:{color:`#ECC48D`,\"--shiki-dark\":`#ECC48D`},children:` install`}),_jsx(_components.span,{style:{color:`#ECC48D`,\"--shiki-dark\":`#ECC48D`},children:` @spree/sdk`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#637777`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#637777`,\"--shiki-dark-font-style\":`italic`},children:`# or`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#82AAFF`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#82AAFF`,\"--shiki-dark-font-style\":`italic`},children:`yarn`}),_jsx(_components.span,{style:{color:`#ECC48D`,\"--shiki-dark\":`#ECC48D`},children:` add`}),_jsx(_components.span,{style:{color:`#ECC48D`,\"--shiki-dark\":`#ECC48D`},children:` @spree/sdk`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#637777`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#637777`,\"--shiki-dark-font-style\":`italic`},children:`# or`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#82AAFF`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#82AAFF`,\"--shiki-dark-font-style\":`italic`},children:`pnpm`}),_jsx(_components.span,{style:{color:`#ECC48D`,\"--shiki-dark\":`#ECC48D`},children:` add`}),_jsx(_components.span,{style:{color:`#ECC48D`,\"--shiki-dark\":`#ECC48D`},children:` @spree/sdk`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`quick-start`,children:`Quick Start`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes night-owl night-owl`,style:{backgroundColor:`#011627`,\"--shiki-dark-bg\":`#011627`,color:`#d6deeb`,\"--shiki-dark\":`#d6deeb`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#C792EA`,\"--shiki-dark-font-style\":`italic`},children:`import`}),_jsx(_components.span,{style:{color:`#D6DEEB`,\"--shiki-dark\":`#D6DEEB`},children:` { createClient } `}),_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#C792EA`,\"--shiki-dark-font-style\":`italic`},children:`from`}),_jsx(_components.span,{style:{color:`#D9F5DD`,\"--shiki-dark\":`#D9F5DD`},children:` '`}),_jsx(_components.span,{style:{color:`#ECC48D`,\"--shiki-dark\":`#ECC48D`},children:`@spree/sdk`}),_jsx(_components.span,{style:{color:`#D9F5DD`,\"--shiki-dark\":`#D9F5DD`},children:`'`}),_jsx(_components.span,{style:{color:`#D6DEEB`,\"--shiki-dark\":`#D6DEEB`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#637777`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#637777`,\"--shiki-dark-font-style\":`italic`},children:`// Initialize the client`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-dark\":`#C792EA`},children:`const`}),_jsx(_components.span,{style:{color:`#82AAFF`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#82AAFF`,\"--shiki-dark-font-style\":`italic`},children:` client`}),_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-dark\":`#C792EA`},children:` =`}),_jsx(_components.span,{style:{color:`#82AAFF`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#82AAFF`,\"--shiki-dark-font-style\":`italic`},children:` createClient`}),_jsx(_components.span,{style:{color:`#D6DEEB`,\"--shiki-dark\":`#D6DEEB`},children:`(`}),_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-dark\":`#C792EA`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#C792EA`,\"--shiki-dark-font-style\":`italic`},children:` baseUrl`}),_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-dark\":`#C792EA`},children:`:`}),_jsx(_components.span,{style:{color:`#D9F5DD`,\"--shiki-dark\":`#D9F5DD`},children:` '`}),_jsx(_components.span,{style:{color:`#ECC48D`,\"--shiki-dark\":`#ECC48D`},children:`http://localhost:3000`}),_jsx(_components.span,{style:{color:`#D9F5DD`,\"--shiki-dark\":`#D9F5DD`},children:`'`}),_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-dark\":`#C792EA`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#C792EA`,\"--shiki-dark-font-style\":`italic`},children:` publishableKey`}),_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-dark\":`#C792EA`},children:`:`}),_jsx(_components.span,{style:{color:`#D9F5DD`,\"--shiki-dark\":`#D9F5DD`},children:` '`}),_jsx(_components.span,{style:{color:`#ECC48D`,\"--shiki-dark\":`#ECC48D`},children:`pk_xxx`}),_jsx(_components.span,{style:{color:`#D9F5DD`,\"--shiki-dark\":`#D9F5DD`},children:`'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C792EA`,\"--shiki-dark\":`#C792EA`},children:`}`}),_jsx(_components.span,{style:{color:`#D6DEEB`,\"--shiki-dark\":`#D6DEEB`},children:`);`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{Since,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":"night-owl"},"config":{},"pageMetadata":{"title":"Store API","sidebarTitle":"Introduction","description":null,"href":"/api-reference/store-api/introduction"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[141,936,")=>null;function _cr"]]},"mdxExtracts":{"tableOfContents":[{"title":"Using SDK","slug":"using-sdk","depth":2,"children":[{"title":"Installation","slug":"installation","depth":3,"children":[]},{"title":"Quick Start","slug":"quick-start","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"spreecommerce","siteName":"Spree Commerce documentation","title":"Store API - Spree Commerce documentation","navMaps":{"firstHrefInVersion":{"v6.x":{"href":"/api-reference/store-api/introduction","matchLevel":0},"v5.x":{"href":"/api-reference/store-api/introduction","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T20:46:56.381Z","originalFileLocation":"api-reference/store-api/introduction.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=\"application-name\" content=\"Spree Commerce documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_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=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Store API - Spree Commerce documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Spree Commerce documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://spreecommerce.org/docs/api-reference/store-api/introduction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spreecommerce.mintlify.app/_mintlify/api/og/v2?division=API+basics\u0026amp;title=Store+API\u0026amp;theme=69587fd3cce8800216628a20\u0026amp;signature=12ad4aebb8bad3806c49384e59aae0aa182b9cdf6b0dc96e8e2e01be6a86ca1e\">\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=\"Store API - Spree Commerce documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spreecommerce.mintlify.app/_mintlify/api/og/v2?division=API+basics\u0026amp;title=Store+API\u0026amp;theme=69587fd3cce8800216628a20\u0026amp;signature=12ad4aebb8bad3806c49384e59aae0aa182b9cdf6b0dc96e8e2e01be6a86ca1e\">\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=\"/docs/mintlify-assets/_mintlify/favicons/spreecommerce/jEa7SqO24dLQoV2O/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Spree Commerce documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0077ff\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://spreecommerce.org/docs/api-reference/store-api/introduction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/store-api/introduction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://spreecommerce.org/#organization\",\"name\":\"Spree Commerce documentation\",\"url\":\"https://spreecommerce.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spreecommerce/LxcAXa2TB_svesfi/logo/logo_light.png?fit=max\u0026auto=format\u0026n=LxcAXa2TB_svesfi\u0026q=85\u0026s=fccc5873d5c7a3eeb4e644f96d694ba9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://spreecommerce.org/docs#website\",\"name\":\"Spree Commerce documentation\",\"url\":\"https://spreecommerce.org/docs\",\"publisher\":{\"@id\":\"https://spreecommerce.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://spreecommerce.org/docs/api-reference/store-api/introduction#webpage\",\"url\":\"https://spreecommerce.org/docs/api-reference/store-api/introduction\",\"name\":\"Store API\",\"dateModified\":\"2026-10-26T20:46:56.381Z\",\"isPartOf\":{\"@id\":\"https://spreecommerce.org/docs#website\"},\"breadcrumb\":{\"@id\":\"https://spreecommerce.org/docs/api-reference/store-api/introduction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://spreecommerce.org/docs/api-reference/store-api/introduction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Spree Commerce documentation\",\"item\":\"https://spreecommerce.org/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Store API\",\"item\":\"https://spreecommerce.org/docs/api-reference/store-api/introduction\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://spreecommerce.org/docs/api-reference/store-api/introduction#article\",\"headline\":\"Store API\",\"name\":\"Store API\",\"url\":\"https://spreecommerce.org/docs/api-reference/store-api/introduction\",\"mainEntityOfPage\":{\"@id\":\"https://spreecommerce.org/docs/api-reference/store-api/introduction#webpage\"},\"dateModified\":\"2026-10-26T20:46:56.381Z\",\"publisher\":{\"@id\":\"https://spreecommerce.org/#organization\"},\"isPartOf\":{\"@id\":\"https://spreecommerce.org/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Spree Commerce documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Spree Commerce documentation","nav":{"global":null,"versions":[{"version":"v6.x","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/developer/getting-started/quickstart"}]},{"tab":"API Reference","menu":[{"item":"Store API","icon":"store","description":"REST API for storefronts and custom integrations","groups":[{"group":"API basics","pages":[{"title":"Store API","sidebarTitle":"Introduction","href":"/api-reference/store-api/introduction"},{"title":"Authentication","sidebarTitle":"Authentication","description":"How to authenticate requests to the Store API","href":"/api-reference/store-api/authentication"},{"title":"Errors","href":"/api-reference/store-api/errors"},{"title":"Idempotency","sidebarTitle":"Idempotency","href":"/api-reference/store-api/idempotency"},{"title":"Rate Limiting","sidebarTitle":"Rate Limiting","href":"/api-reference/store-api/rate-limitting"},{"title":"Querying","sidebarTitle":"Querying","href":"/api-reference/store-api/querying"},{"title":"Relations","sidebarTitle":"Relations","href":"/api-reference/store-api/relations"},{"title":"Metadata","sidebarTitle":"Metadata","href":"/api-reference/store-api/metadata"},{"title":"Localization","sidebarTitle":"Localization","href":"/api-reference/store-api/localization"},{"title":"Monetary Amounts","sidebarTitle":"Monetary Amounts","href":"/api-reference/store-api/monetary-amounts"},{"title":"Migrating from Storefront API v2","sidebarTitle":"Migrating from v2","href":"/api-reference/store-api/migrating-from-storefront-api-v2"}]},{"group":"Endpoints","pages":[{"group":"Authentication","pages":[{"title":"Login","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/auth/login","href":"/api-reference/store-api/authentication/login"},{"title":"Refresh token","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/auth/refresh","href":"/api-reference/store-api/authentication/refresh-token"},{"title":"Logout","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/auth/logout","href":"/api-reference/store-api/authentication/logout"},{"title":"Request a password reset","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/password_resets","href":"/api-reference/store-api/authentication/request-a-password-reset"},{"title":"Reset password with token","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/password_resets/{token}","href":"/api-reference/store-api/authentication/reset-password-with-token"}]},{"group":"Product Catalog","pages":[{"title":"List categories","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/categories","href":"/api-reference/store-api/product-catalog/list-categories"},{"title":"Get a category","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/categories/{id}","href":"/api-reference/store-api/product-catalog/get-a-category"},{"title":"List collections","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/collections","href":"/api-reference/store-api/product-catalog/list-collections"},{"title":"Get a collection","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/collections/{id}","href":"/api-reference/store-api/product-catalog/get-a-collection"},{"title":"List collection products","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/collections/{collection_id}/products","href":"/api-reference/store-api/product-catalog/list-collection-products"},{"title":"List products","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/products","href":"/api-reference/store-api/product-catalog/list-products"},{"title":"Get a product","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/products/{id}","href":"/api-reference/store-api/product-catalog/get-a-product"},{"title":"Get product filters","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/products/filters","href":"/api-reference/store-api/product-catalog/get-product-filters"}]},{"group":"Carts","pages":[{"title":"List addresses this cart may use","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/carts/{cart_id}/addresses","href":"/api-reference/store-api/carts/list-addresses-this-cart-may-use"},{"title":"Upload a purchase order document","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/po_document","href":"/api-reference/store-api/carts/upload-a-purchase-order-document"},{"title":"Set the cart tax identifier","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/tax_identifier","href":"/api-reference/store-api/carts/set-the-cart-tax-identifier"},{"title":"List active carts","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/carts","href":"/api-reference/store-api/carts/list-active-carts"},{"title":"Create a new cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts","href":"/api-reference/store-api/carts/create-a-new-cart"},{"title":"Get a cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/carts/{id}","href":"/api-reference/store-api/carts/get-a-cart"},{"title":"Delete a cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{id}","href":"/api-reference/store-api/carts/delete-a-cart"},{"title":"Update a cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{id}","href":"/api-reference/store-api/carts/update-a-cart"},{"title":"Associate guest cart with authenticated user","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{id}/associate","href":"/api-reference/store-api/carts/associate-guest-cart-with-authenticated-user"},{"title":"Complete cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{id}/complete","href":"/api-reference/store-api/carts/complete-cart"},{"title":"Apply discount code","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/discount_codes","href":"/api-reference/store-api/carts/apply-discount-code"},{"title":"Remove discount code","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{cart_id}/discount_codes/{id}","href":"/api-reference/store-api/carts/remove-discount-code"},{"title":"Select delivery rate for fulfillment","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/fulfillments/{id}","href":"/api-reference/store-api/carts/select-delivery-rate-for-fulfillment"},{"title":"Apply gift card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/gift_cards","href":"/api-reference/store-api/carts/apply-gift-card"},{"title":"Remove gift card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{cart_id}/gift_cards/{id}","href":"/api-reference/store-api/carts/remove-gift-card"},{"title":"Add item to cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/items","href":"/api-reference/store-api/carts/add-item-to-cart"},{"title":"Remove line item from cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{cart_id}/items/{id}","href":"/api-reference/store-api/carts/remove-line-item-from-cart"},{"title":"Update line item quantity","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/items/{id}","href":"/api-reference/store-api/carts/update-line-item-quantity"},{"title":"Create payment session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/payment_sessions","href":"/api-reference/store-api/carts/create-payment-session"},{"title":"Get payment session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/carts/{cart_id}/payment_sessions/{id}","href":"/api-reference/store-api/carts/get-payment-session"},{"title":"Update payment session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/payment_sessions/{id}","href":"/api-reference/store-api/carts/update-payment-session"},{"title":"Complete payment session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/payment_sessions/{id}/complete","href":"/api-reference/store-api/carts/complete-payment-session"},{"title":"Create payment","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/payments","href":"/api-reference/store-api/carts/create-payment"},{"title":"Apply store credit","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/store_credits","href":"/api-reference/store-api/carts/apply-store-credit"},{"title":"Remove store credit","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{cart_id}/store_credits","href":"/api-reference/store-api/carts/remove-store-credit"}]},{"group":"Orders","pages":[{"title":"List claims","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/orders/{order_id}/claims","href":"/api-reference/store-api/orders/list-claims"},{"title":"Open a claim","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/orders/{order_id}/claims","href":"/api-reference/store-api/orders/open-a-claim"},{"title":"Get an order","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/orders/{id}","href":"/api-reference/store-api/orders/get-an-order"},{"title":"List returns","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/orders/{order_id}/returns","href":"/api-reference/store-api/orders/list-returns"},{"title":"Open a return","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/orders/{order_id}/returns","href":"/api-reference/store-api/orders/open-a-return"}]},{"group":"Customers","pages":[{"title":"List customer addresses","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/addresses","href":"/api-reference/store-api/customers/list-customer-addresses"},{"title":"Create an address","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/customers/me/addresses","href":"/api-reference/store-api/customers/create-an-address"},{"title":"Get an address","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/addresses/{id}","href":"/api-reference/store-api/customers/get-an-address"},{"title":"Delete an address","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/customers/me/addresses/{id}","href":"/api-reference/store-api/customers/delete-an-address"},{"title":"Update an address","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/customers/me/addresses/{id}","href":"/api-reference/store-api/customers/update-an-address"},{"title":"List saved credit cards","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/credit_cards","href":"/api-reference/store-api/customers/list-saved-credit-cards"},{"title":"Get a credit card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/credit_cards/{id}","href":"/api-reference/store-api/customers/get-a-credit-card"},{"title":"Delete a credit card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/customers/me/credit_cards/{id}","href":"/api-reference/store-api/customers/delete-a-credit-card"},{"title":"List orders","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/orders","href":"/api-reference/store-api/customers/list-orders"},{"title":"Get an order","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/orders/{id}","href":"/api-reference/store-api/customers/get-an-order"},{"title":"Register a new customer","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/customers","href":"/api-reference/store-api/customers/register-a-new-customer"},{"title":"Get current customer profile","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me","href":"/api-reference/store-api/customers/get-current-customer-profile"},{"title":"Update current customer profile","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/customers/me","href":"/api-reference/store-api/customers/update-current-customer-profile"},{"title":"List data requests","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/data_requests","href":"/api-reference/store-api/customers/list-data-requests"},{"title":"Open a data request","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/customers/me/data_requests","href":"/api-reference/store-api/customers/open-a-data-request"},{"title":"Get a data request","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/data_requests/{id}","href":"/api-reference/store-api/customers/get-a-data-request"},{"title":"Get a data request by its confirmation token","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/data_requests/{token}","href":"/api-reference/store-api/customers/get-a-data-request-by-its-confirmation-token"},{"title":"Confirm a data request","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/data_requests/{token}/confirmation","href":"/api-reference/store-api/customers/confirm-a-data-request"},{"title":"List gift cards","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/gift_cards","href":"/api-reference/store-api/customers/list-gift-cards"},{"title":"Get a gift card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/gift_cards/{id}","href":"/api-reference/store-api/customers/get-a-gift-card"},{"title":"Create payment setup session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/customers/me/payment_setup_sessions","href":"/api-reference/store-api/customers/create-payment-setup-session"},{"title":"Get payment setup session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/payment_setup_sessions/{id}","href":"/api-reference/store-api/customers/get-payment-setup-session"},{"title":"Complete payment setup session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/customers/me/payment_setup_sessions/{id}/complete","href":"/api-reference/store-api/customers/complete-payment-setup-session"},{"title":"List store credits","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/store_credits","href":"/api-reference/store-api/customers/list-store-credits"},{"title":"Get a store credit","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/store_credits/{id}","href":"/api-reference/store-api/customers/get-a-store-credit"}]},{"group":"Markets","pages":[{"title":"List countries","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/countries","href":"/api-reference/store-api/markets/list-countries"},{"title":"Get a country","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/countries/{iso}","href":"/api-reference/store-api/markets/get-a-country"},{"title":"List supported currencies","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/currencies","href":"/api-reference/store-api/markets/list-supported-currencies"},{"title":"List supported locales","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/locales","href":"/api-reference/store-api/markets/list-supported-locales"},{"title":"List markets","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets","href":"/api-reference/store-api/markets/list-markets"},{"title":"Get a market","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets/{id}","href":"/api-reference/store-api/markets/get-a-market"},{"title":"Resolve market by country","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets/resolve","href":"/api-reference/store-api/markets/resolve-market-by-country"},{"title":"List countries in a market","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets/{market_id}/countries","href":"/api-reference/store-api/markets/list-countries-in-a-market"},{"title":"Get a country in a market","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets/{market_id}/countries/{id}","href":"/api-reference/store-api/markets/get-a-country-in-a-market"}]},{"group":"Wishlists","pages":[{"title":"List wishlists","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/wishlists","href":"/api-reference/store-api/wishlists/list-wishlists"},{"title":"Create a wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/wishlists","href":"/api-reference/store-api/wishlists/create-a-wishlist"},{"title":"Get a wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/wishlists/{id}","href":"/api-reference/store-api/wishlists/get-a-wishlist"},{"title":"Delete a wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/wishlists/{id}","href":"/api-reference/store-api/wishlists/delete-a-wishlist"},{"title":"Update a wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/wishlists/{id}","href":"/api-reference/store-api/wishlists/update-a-wishlist"},{"title":"Add item to wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/wishlists/{wishlist_id}/items","href":"/api-reference/store-api/wishlists/add-item-to-wishlist"},{"title":"Remove item from wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/wishlists/{wishlist_id}/items/{id}","href":"/api-reference/store-api/wishlists/remove-item-from-wishlist"},{"title":"Update a wishlist item","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/wishlists/{wishlist_id}/items/{id}","href":"/api-reference/store-api/wishlists/update-a-wishlist-item"}]},{"group":"Newsletter Subscribers","pages":[{"title":"Subscribe to the newsletter","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/newsletter_subscribers","href":"/api-reference/store-api/newsletter-subscribers/subscribe-to-the-newsletter"},{"title":"Verify a newsletter subscription","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/newsletter_subscribers/verify","href":"/api-reference/store-api/newsletter-subscribers/verify-a-newsletter-subscription"},{"title":"Unsubscribe from the newsletter","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/newsletter_subscribers/{id}","href":"/api-reference/store-api/newsletter-subscribers/unsubscribe-from-the-newsletter"},{"title":"Request an unsubscribe token","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/newsletter_subscribers/request_unsubscribe","href":"/api-reference/store-api/newsletter-subscribers/request-an-unsubscribe-token"}]},{"group":"Policies","pages":[{"title":"List store policies","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/policies","href":"/api-reference/store-api/policies/list-store-policies"},{"title":"Get a policy","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/policies/{id}","href":"/api-reference/store-api/policies/get-a-policy"}]},{"group":"Channel","pages":[{"title":"Get the current channel","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/channel","href":"/api-reference/store-api/channel/get-the-current-channel"}]},{"group":"Companies","pages":[{"title":"List my company memberships","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/account/companies","href":"/api-reference/store-api/companies/list-my-company-memberships"},{"title":"Get a company node","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{id}","href":"/api-reference/store-api/companies/get-a-company-node"},{"title":"Update a company node","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/companies/{id}","href":"/api-reference/store-api/companies/update-a-company-node"},{"title":"List company members","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{company_id}/members","href":"/api-reference/store-api/companies/list-company-members"},{"title":"Add a member by email","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/companies/{company_id}/members","href":"/api-reference/store-api/companies/add-a-member-by-email"},{"title":"List pending company invitations","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{company_id}/invitations","href":"/api-reference/store-api/companies/list-pending-company-invitations"},{"title":"List the company address book","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{company_id}/addresses","href":"/api-reference/store-api/companies/list-the-company-address-book"},{"title":"Add an address book entry","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/companies/{company_id}/addresses","href":"/api-reference/store-api/companies/add-an-address-book-entry"},{"title":"Remove an address book entry","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/companies/{company_id}/addresses/{id}","href":"/api-reference/store-api/companies/remove-an-address-book-entry"},{"title":"Update an address book entry","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/companies/{company_id}/addresses/{id}","href":"/api-reference/store-api/companies/update-an-address-book-entry"},{"title":"Revoke an invitation","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/companies/{company_id}/invitations/{id}","href":"/api-reference/store-api/companies/revoke-an-invitation"},{"title":"List the company purchases","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{company_id}/orders","href":"/api-reference/store-api/companies/list-the-company-purchases"},{"title":"Look up an invitation","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/company_invitations/{token}","href":"/api-reference/store-api/companies/look-up-an-invitation"},{"title":"Accept an invitation","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/company_invitations/{token}/accept","href":"/api-reference/store-api/companies/accept-an-invitation"}]},{"group":"Delivery","pages":[{"title":"List delivery methods","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/delivery_methods","href":"/api-reference/store-api/delivery/list-delivery-methods"},{"title":"List pickup locations","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/delivery_methods/{id}/pickup_locations","href":"/api-reference/store-api/delivery/list-pickup-locations"}]},{"group":"Digital Links","pages":[{"title":"List my digital links","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/digital_links","href":"/api-reference/store-api/digital-links/list-my-digital-links"},{"title":"Download a digital product","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/digital_links/{token}","href":"/api-reference/store-api/digital-links/download-a-digital-product"}]},{"group":"Sellers","pages":[{"title":"List sellers","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/sellers","href":"/api-reference/store-api/sellers/list-sellers"},{"title":"Get a seller","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/sellers/{id}","href":"/api-reference/store-api/sellers/get-a-seller"}]}]}]},{"item":"Admin API","icon":"shield","description":"REST API for pragmatically managing stores","pages":[{"title":"Admin API","href":"/api-reference/admin-api/introduction"}]},{"item":"Seller API","icon":"shop","description":"REST API for the marketplace seller panel","pages":[{"title":"Seller API","href":"/api-reference/seller-api/introduction"}]},{"item":"Webhooks","icon":"webhook","description":"Event payloads and delivery reference","pages":[{"title":"Webhooks","href":"/api-reference/webhooks-events"}]}]},{"tab":"User Guide","pages":[{"title":"User Guide","href":"/user/what-is-spree-commerce"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"version":"v5.x","tabs":[{"tab":"Guides","menu":[{"item":"Getting Started","icon":"rocket","description":"Quickstart guide and core concepts","pages":[{"title":"Getting Started","href":"/v5/developer/getting-started/quickstart"}]},{"item":"Building a Storefront","icon":"store","description":"Next.js, custom frontend, or Rails engine","pages":[{"title":"Building a Storefront","href":"/v5/developer/storefront/nextjs/quickstart"}]},{"item":"Use Cases","icon":"book-open","description":"Multi-store/multi-tenant, and marketplace setups","pages":[{"title":"Use Cases","href":"/v5/developer/multi-tenant/quickstart"}]}],"pages":[{"title":"Guides","href":"/v5/developer/getting-started/quickstart"}]},{"tab":"Framework","menu":[{"item":"Extending","icon":"puzzle","description":"Customize admin panel, API, and business logic","pages":[{"title":"Extending","href":"/v5/developer/tutorial/introduction"}]},{"item":"How-to Guides","icon":"book-open","description":"Step-by-step guides for common tasks","pages":[{"title":"How-to Guides","href":"/v5/developer/how-to/custom-order-routing"}]},{"item":"Operations","icon":"server","description":"Deploy, upgrade, and maintain your store","pages":[{"title":"Operations","href":"/v5/developer/deployment/quickstart"}]}],"pages":[{"title":"Framework","href":"/v5/developer/tutorial/introduction"}]},{"tab":"SDK \u0026 Tools","menu":[{"item":"Store SDK","icon":"code","description":"TypeScript SDK for the Store API","pages":[{"title":"Store SDK","href":"/v5/developer/sdk/quickstart"}]},{"item":"Admin SDK","icon":"shield-check","description":"TypeScript SDK for the Admin API","pages":[{"title":"Admin SDK","href":"/v5/developer/sdk/admin/quickstart"}]},{"item":"CLI","icon":"square-terminal","description":"Command-line interface for Spree","pages":[{"title":"CLI","href":"/v5/developer/cli/quickstart"}]},{"item":"create-spree-app","icon":"rocket","description":"Scaffold a new Spree project","pages":[{"title":"create-spree-app","href":"/v5/developer/create-spree-app/quickstart"}]},{"item":"Agentic Development","icon":"bot","description":"Build Spree with AI coding agents","pages":[{"title":"Agentic Development","href":"/v5/developer/agentic/overview"}]}],"pages":[{"title":"SDK \u0026 Tools","href":"/v5/developer/sdk/quickstart"}]},{"tab":"API Reference","menu":[{"item":"Store API","icon":"store","description":"REST API for storefronts and custom integrations","groups":[{"group":"API basics","pages":[{"title":"Store API","sidebarTitle":"Introduction","href":"/api-reference/store-api/introduction"},{"title":"Authentication","sidebarTitle":"Authentication","description":"How to authenticate requests to the Store API","href":"/api-reference/store-api/authentication"},{"title":"Errors","href":"/api-reference/store-api/errors"},{"title":"Idempotency","sidebarTitle":"Idempotency","href":"/api-reference/store-api/idempotency"},{"title":"Rate Limiting","sidebarTitle":"Rate Limiting","href":"/api-reference/store-api/rate-limitting"},{"title":"Querying","sidebarTitle":"Querying","href":"/api-reference/store-api/querying"},{"title":"Relations","sidebarTitle":"Relations","href":"/api-reference/store-api/relations"},{"title":"Metadata","sidebarTitle":"Metadata","href":"/api-reference/store-api/metadata"},{"title":"Localization","sidebarTitle":"Localization","href":"/api-reference/store-api/localization"},{"title":"Monetary Amounts","sidebarTitle":"Monetary Amounts","href":"/api-reference/store-api/monetary-amounts"},{"title":"Migrating from Storefront API v2","sidebarTitle":"Migrating from v2","href":"/api-reference/store-api/migrating-from-storefront-api-v2"}]},{"group":"Endpoints","pages":[{"group":"Authentication","pages":[{"title":"Login","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/auth/login","href":"/api-reference/store-api/authentication/login"},{"title":"Refresh token","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/auth/refresh","href":"/api-reference/store-api/authentication/refresh-token"},{"title":"Logout","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/auth/logout","href":"/api-reference/store-api/authentication/logout"},{"title":"Request a password reset","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/password_resets","href":"/api-reference/store-api/authentication/request-a-password-reset"},{"title":"Reset password with token","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/password_resets/{token}","href":"/api-reference/store-api/authentication/reset-password-with-token"}]},{"group":"Product Catalog","pages":[{"title":"List categories","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/categories","href":"/api-reference/store-api/product-catalog/list-categories"},{"title":"Get a category","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/categories/{id}","href":"/api-reference/store-api/product-catalog/get-a-category"},{"title":"List collections","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/collections","href":"/api-reference/store-api/product-catalog/list-collections"},{"title":"Get a collection","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/collections/{id}","href":"/api-reference/store-api/product-catalog/get-a-collection"},{"title":"List collection products","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/collections/{collection_id}/products","href":"/api-reference/store-api/product-catalog/list-collection-products"},{"title":"List products","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/products","href":"/api-reference/store-api/product-catalog/list-products"},{"title":"Get a product","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/products/{id}","href":"/api-reference/store-api/product-catalog/get-a-product"},{"title":"Get product filters","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/products/filters","href":"/api-reference/store-api/product-catalog/get-product-filters"}]},{"group":"Carts","pages":[{"title":"List addresses this cart may use","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/carts/{cart_id}/addresses","href":"/api-reference/store-api/carts/list-addresses-this-cart-may-use"},{"title":"Upload a purchase order document","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/po_document","href":"/api-reference/store-api/carts/upload-a-purchase-order-document"},{"title":"Set the cart tax identifier","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/tax_identifier","href":"/api-reference/store-api/carts/set-the-cart-tax-identifier"},{"title":"List active carts","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/carts","href":"/api-reference/store-api/carts/list-active-carts"},{"title":"Create a new cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts","href":"/api-reference/store-api/carts/create-a-new-cart"},{"title":"Get a cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/carts/{id}","href":"/api-reference/store-api/carts/get-a-cart"},{"title":"Delete a cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{id}","href":"/api-reference/store-api/carts/delete-a-cart"},{"title":"Update a cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{id}","href":"/api-reference/store-api/carts/update-a-cart"},{"title":"Associate guest cart with authenticated user","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{id}/associate","href":"/api-reference/store-api/carts/associate-guest-cart-with-authenticated-user"},{"title":"Complete cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{id}/complete","href":"/api-reference/store-api/carts/complete-cart"},{"title":"Apply discount code","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/discount_codes","href":"/api-reference/store-api/carts/apply-discount-code"},{"title":"Remove discount code","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{cart_id}/discount_codes/{id}","href":"/api-reference/store-api/carts/remove-discount-code"},{"title":"Select delivery rate for fulfillment","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/fulfillments/{id}","href":"/api-reference/store-api/carts/select-delivery-rate-for-fulfillment"},{"title":"Apply gift card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/gift_cards","href":"/api-reference/store-api/carts/apply-gift-card"},{"title":"Remove gift card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{cart_id}/gift_cards/{id}","href":"/api-reference/store-api/carts/remove-gift-card"},{"title":"Add item to cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/items","href":"/api-reference/store-api/carts/add-item-to-cart"},{"title":"Remove line item from cart","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{cart_id}/items/{id}","href":"/api-reference/store-api/carts/remove-line-item-from-cart"},{"title":"Update line item quantity","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/items/{id}","href":"/api-reference/store-api/carts/update-line-item-quantity"},{"title":"Create payment session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/payment_sessions","href":"/api-reference/store-api/carts/create-payment-session"},{"title":"Get payment session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/carts/{cart_id}/payment_sessions/{id}","href":"/api-reference/store-api/carts/get-payment-session"},{"title":"Update payment session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/payment_sessions/{id}","href":"/api-reference/store-api/carts/update-payment-session"},{"title":"Complete payment session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/carts/{cart_id}/payment_sessions/{id}/complete","href":"/api-reference/store-api/carts/complete-payment-session"},{"title":"Create payment","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/payments","href":"/api-reference/store-api/carts/create-payment"},{"title":"Apply store credit","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/carts/{cart_id}/store_credits","href":"/api-reference/store-api/carts/apply-store-credit"},{"title":"Remove store credit","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/carts/{cart_id}/store_credits","href":"/api-reference/store-api/carts/remove-store-credit"}]},{"group":"Orders","pages":[{"title":"List claims","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/orders/{order_id}/claims","href":"/api-reference/store-api/orders/list-claims"},{"title":"Open a claim","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/orders/{order_id}/claims","href":"/api-reference/store-api/orders/open-a-claim"},{"title":"Get an order","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/orders/{id}","href":"/api-reference/store-api/orders/get-an-order"},{"title":"List returns","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/orders/{order_id}/returns","href":"/api-reference/store-api/orders/list-returns"},{"title":"Open a return","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/orders/{order_id}/returns","href":"/api-reference/store-api/orders/open-a-return"}]},{"group":"Customers","pages":[{"title":"List customer addresses","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/addresses","href":"/api-reference/store-api/customers/list-customer-addresses"},{"title":"Create an address","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/customers/me/addresses","href":"/api-reference/store-api/customers/create-an-address"},{"title":"Get an address","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/addresses/{id}","href":"/api-reference/store-api/customers/get-an-address"},{"title":"Delete an address","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/customers/me/addresses/{id}","href":"/api-reference/store-api/customers/delete-an-address"},{"title":"Update an address","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/customers/me/addresses/{id}","href":"/api-reference/store-api/customers/update-an-address"},{"title":"List saved credit cards","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/credit_cards","href":"/api-reference/store-api/customers/list-saved-credit-cards"},{"title":"Get a credit card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/credit_cards/{id}","href":"/api-reference/store-api/customers/get-a-credit-card"},{"title":"Delete a credit card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/customers/me/credit_cards/{id}","href":"/api-reference/store-api/customers/delete-a-credit-card"},{"title":"List orders","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/orders","href":"/api-reference/store-api/customers/list-orders"},{"title":"Get an order","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/orders/{id}","href":"/api-reference/store-api/customers/get-an-order"},{"title":"Register a new customer","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/customers","href":"/api-reference/store-api/customers/register-a-new-customer"},{"title":"Get current customer profile","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me","href":"/api-reference/store-api/customers/get-current-customer-profile"},{"title":"Update current customer profile","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/customers/me","href":"/api-reference/store-api/customers/update-current-customer-profile"},{"title":"List data requests","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/data_requests","href":"/api-reference/store-api/customers/list-data-requests"},{"title":"Open a data request","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/customers/me/data_requests","href":"/api-reference/store-api/customers/open-a-data-request"},{"title":"Get a data request","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/data_requests/{id}","href":"/api-reference/store-api/customers/get-a-data-request"},{"title":"Get a data request by its confirmation token","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/data_requests/{token}","href":"/api-reference/store-api/customers/get-a-data-request-by-its-confirmation-token"},{"title":"Confirm a data request","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/data_requests/{token}/confirmation","href":"/api-reference/store-api/customers/confirm-a-data-request"},{"title":"List gift cards","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/gift_cards","href":"/api-reference/store-api/customers/list-gift-cards"},{"title":"Get a gift card","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/gift_cards/{id}","href":"/api-reference/store-api/customers/get-a-gift-card"},{"title":"Create payment setup session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/customers/me/payment_setup_sessions","href":"/api-reference/store-api/customers/create-payment-setup-session"},{"title":"Get payment setup session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/payment_setup_sessions/{id}","href":"/api-reference/store-api/customers/get-payment-setup-session"},{"title":"Complete payment setup session","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/customers/me/payment_setup_sessions/{id}/complete","href":"/api-reference/store-api/customers/complete-payment-setup-session"},{"title":"List store credits","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/store_credits","href":"/api-reference/store-api/customers/list-store-credits"},{"title":"Get a store credit","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/store_credits/{id}","href":"/api-reference/store-api/customers/get-a-store-credit"}]},{"group":"Markets","pages":[{"title":"List countries","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/countries","href":"/api-reference/store-api/markets/list-countries"},{"title":"Get a country","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/countries/{iso}","href":"/api-reference/store-api/markets/get-a-country"},{"title":"List supported currencies","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/currencies","href":"/api-reference/store-api/markets/list-supported-currencies"},{"title":"List supported locales","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/locales","href":"/api-reference/store-api/markets/list-supported-locales"},{"title":"List markets","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets","href":"/api-reference/store-api/markets/list-markets"},{"title":"Get a market","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets/{id}","href":"/api-reference/store-api/markets/get-a-market"},{"title":"Resolve market by country","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets/resolve","href":"/api-reference/store-api/markets/resolve-market-by-country"},{"title":"List countries in a market","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets/{market_id}/countries","href":"/api-reference/store-api/markets/list-countries-in-a-market"},{"title":"Get a country in a market","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/markets/{market_id}/countries/{id}","href":"/api-reference/store-api/markets/get-a-country-in-a-market"}]},{"group":"Wishlists","pages":[{"title":"List wishlists","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/wishlists","href":"/api-reference/store-api/wishlists/list-wishlists"},{"title":"Create a wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/wishlists","href":"/api-reference/store-api/wishlists/create-a-wishlist"},{"title":"Get a wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/wishlists/{id}","href":"/api-reference/store-api/wishlists/get-a-wishlist"},{"title":"Delete a wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/wishlists/{id}","href":"/api-reference/store-api/wishlists/delete-a-wishlist"},{"title":"Update a wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/wishlists/{id}","href":"/api-reference/store-api/wishlists/update-a-wishlist"},{"title":"Add item to wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/wishlists/{wishlist_id}/items","href":"/api-reference/store-api/wishlists/add-item-to-wishlist"},{"title":"Remove item from wishlist","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/wishlists/{wishlist_id}/items/{id}","href":"/api-reference/store-api/wishlists/remove-item-from-wishlist"},{"title":"Update a wishlist item","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/wishlists/{wishlist_id}/items/{id}","href":"/api-reference/store-api/wishlists/update-a-wishlist-item"}]},{"group":"Newsletter Subscribers","pages":[{"title":"Subscribe to the newsletter","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/newsletter_subscribers","href":"/api-reference/store-api/newsletter-subscribers/subscribe-to-the-newsletter"},{"title":"Verify a newsletter subscription","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/newsletter_subscribers/verify","href":"/api-reference/store-api/newsletter-subscribers/verify-a-newsletter-subscription"},{"title":"Unsubscribe from the newsletter","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/newsletter_subscribers/{id}","href":"/api-reference/store-api/newsletter-subscribers/unsubscribe-from-the-newsletter"},{"title":"Request an unsubscribe token","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/newsletter_subscribers/request_unsubscribe","href":"/api-reference/store-api/newsletter-subscribers/request-an-unsubscribe-token"}]},{"group":"Policies","pages":[{"title":"List store policies","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/policies","href":"/api-reference/store-api/policies/list-store-policies"},{"title":"Get a policy","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/policies/{id}","href":"/api-reference/store-api/policies/get-a-policy"}]},{"group":"Channel","pages":[{"title":"Get the current channel","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/channel","href":"/api-reference/store-api/channel/get-the-current-channel"}]},{"group":"Companies","pages":[{"title":"List my company memberships","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/account/companies","href":"/api-reference/store-api/companies/list-my-company-memberships"},{"title":"Get a company node","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{id}","href":"/api-reference/store-api/companies/get-a-company-node"},{"title":"Update a company node","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/companies/{id}","href":"/api-reference/store-api/companies/update-a-company-node"},{"title":"List company members","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{company_id}/members","href":"/api-reference/store-api/companies/list-company-members"},{"title":"Add a member by email","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/companies/{company_id}/members","href":"/api-reference/store-api/companies/add-a-member-by-email"},{"title":"List pending company invitations","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{company_id}/invitations","href":"/api-reference/store-api/companies/list-pending-company-invitations"},{"title":"List the company address book","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{company_id}/addresses","href":"/api-reference/store-api/companies/list-the-company-address-book"},{"title":"Add an address book entry","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/companies/{company_id}/addresses","href":"/api-reference/store-api/companies/add-an-address-book-entry"},{"title":"Remove an address book entry","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/companies/{company_id}/addresses/{id}","href":"/api-reference/store-api/companies/remove-an-address-book-entry"},{"title":"Update an address book entry","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml patch /api/v3/store/companies/{company_id}/addresses/{id}","href":"/api-reference/store-api/companies/update-an-address-book-entry"},{"title":"Revoke an invitation","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml delete /api/v3/store/companies/{company_id}/invitations/{id}","href":"/api-reference/store-api/companies/revoke-an-invitation"},{"title":"List the company purchases","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/companies/{company_id}/orders","href":"/api-reference/store-api/companies/list-the-company-purchases"},{"title":"Look up an invitation","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/company_invitations/{token}","href":"/api-reference/store-api/companies/look-up-an-invitation"},{"title":"Accept an invitation","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml post /api/v3/store/company_invitations/{token}/accept","href":"/api-reference/store-api/companies/accept-an-invitation"}]},{"group":"Delivery","pages":[{"title":"List delivery methods","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/delivery_methods","href":"/api-reference/store-api/delivery/list-delivery-methods"},{"title":"List pickup locations","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/delivery_methods/{id}/pickup_locations","href":"/api-reference/store-api/delivery/list-pickup-locations"}]},{"group":"Digital Links","pages":[{"title":"List my digital links","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/customers/me/digital_links","href":"/api-reference/store-api/digital-links/list-my-digital-links"},{"title":"Download a digital product","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/digital_links/{token}","href":"/api-reference/store-api/digital-links/download-a-digital-product"}]},{"group":"Sellers","pages":[{"title":"List sellers","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/sellers","href":"/api-reference/store-api/sellers/list-sellers"},{"title":"Get a seller","deprecated":null,"version":null,"openapi":"/api-reference/store.yaml get /api/v3/store/sellers/{id}","href":"/api-reference/store-api/sellers/get-a-seller"}]}]}]},{"item":"Admin API","icon":"shield","description":"REST API for pragmatically managing stores","pages":[{"title":"Admin API","href":"/api-reference/admin-api/introduction"}]},{"item":"Webhooks","icon":"webhook","description":"Event payloads and delivery reference","pages":[{"title":"Webhooks","href":"/api-reference/webhooks-events"}]},{"item":"Legacy API v2","icon":"clock","description":"Previous-generation Storefront and Platform APIs","pages":[{"title":"Legacy API v2","href":"/api-reference/v2/introduction"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/integrations"}]},{"tab":"User Guide","pages":[{"title":"User Guide","href":"/v5/user/what-is-spree-commerce"}]}]}]},"title":"Store API - Spree Commerce documentation","buildId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":[],"chunks":[]}