Find the API access card and click Generate API Key.
Copy the key from the modal.
The key is shown only once, at the moment of creation. Retailgrid does not store the plaintext value, so it cannot be retrieved later. Save it to your secret manager immediately.
Each account can have one active key at a time. Generating a new key replaces the previous one - existing integrations using the old key will start receiving 401 Unauthorized and need to be updated.
Verify a key
The fastest way to check that a key works is to call GET /v1/auth/verify:
Header missing, malformed, or the key is no longer active (rotated, revoked, or deleted).
403 Forbidden
Key is valid but does not have access to the requested resource.
Security guidance
Never commit keys to source control. Use environment variables, a secrets manager, or your CI’s encrypted variables.
Rotate on suspicion. Generating a new key in the UI immediately invalidates the previous one. There is no separate revoke step.
Use a dedicated key per integration where possible - because each account holds one active key today, plan key rotations to align with deploys of dependent services.
Treat keys like passwords. A leaked key gives full read/write access to your Retailgrid catalog and transactions.
Need help?
If a key stops working unexpectedly or you need a key reset for an account you no longer have UI access to, contact support.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Retailgrid Documentation","description":"Organize, enrich and optimize your products with AI.","colors":{"primary":"#1E40AF","light":"#1E40AF","dark":"#92b7f2"},"logo":{"light":"https://mintcdn.com/retailgrid/OV_G2hLQBJ93ME2e/images/retailgrid-mark-dark-1200.png?fit=max\u0026auto=format\u0026n=OV_G2hLQBJ93ME2e\u0026q=85\u0026s=2b4dca9e40af4b82015237e9abe65e3d","dark":"https://mintcdn.com/retailgrid/_m0DRGn8-2PbQfaR/images/retailgrid-logo-horizontal-white.png?fit=max\u0026auto=format\u0026n=_m0DRGn8-2PbQfaR\u0026q=85\u0026s=7889bc086af80155cde4c44f847bded9","href":"https://www.retailgrid.io/"},"favicon":{"light":"https://mintcdn.com/retailgrid/_m0DRGn8-2PbQfaR/images/retailgrid-mark.png?fit=max\u0026auto=format\u0026n=_m0DRGn8-2PbQfaR\u0026q=85\u0026s=0641304d9edeaf35f9dca3748020a6a0","dark":"https://mintcdn.com/retailgrid/OV_G2hLQBJ93ME2e/images/retailgrid-mark-white.svg?fit=max\u0026auto=format\u0026n=OV_G2hLQBJ93ME2e\u0026q=85\u0026s=0db3811dc2604dcc53b1dace62d99c06"},"api":{"playground":{"proxy":false}},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FFFFFF"}},"navbar":{"links":[{"href":"https://app.retailgrid.io","label":"Get started"}],"primary":{"type":"button","label":"Talk to us","href":"https://www.retailgrid.io/contact"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/retailgrid"}},"seo":{"indexing":"all"},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"get-started/overview"},{"language":"es","href":"es/get-started/overview"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"retailgrid","hasAudioNarration":false,"actualSubdomain":"retailgrid","customDomains":["docs.retailgrid.io"],"gitSource":{"type":"github","owner":"retailgrid","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afc7d578d58fd8eef0394f3","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"en","tag":"Documentation","count":108},{"language":"es","tag":"Documentación","count":108},{"language":"default","tag":"Documentation","count":58},{"language":"default","tag":"API","count":58},{"language":"en","tag":"Guides","count":56},{"language":"es","tag":"Guías","count":56},{"language":"en","tag":"API","count":44},{"language":"es","tag":"API","count":44},{"language":"en","tag":"Agents","count":12},{"language":"en","tag":"Settings","count":12},{"language":"es","tag":"Agentes","count":12},{"language":"es","tag":"Configuración","count":12},{"language":"default","tag":"competitor_prices","count":11},{"language":"en","tag":"Grids","count":9},{"language":"es","tag":"Grids","count":9},{"language":"en","tag":"Overview","count":8},{"language":"es","tag":"Descripción general","count":8},{"language":"default","tag":"matching","count":8},{"language":"en","tag":"Reference","count":7},{"language":"es","tag":"Referencia","count":7},{"language":"default","tag":"products","count":7},{"language":"default","tag":"transactions","count":7},{"language":"en","tag":"Matching","count":6},{"language":"en","tag":"Products","count":6},{"language":"es","tag":"Matching","count":6},{"language":"es","tag":"Productos","count":6},{"language":"default","tag":"imports","count":6},{"language":"default","tag":"product_store","count":6},{"language":"default","tag":"transaction exports","count":4},{"language":"default","tag":"approved_prices","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/authentication","slug":"/api-reference/authentication","pageMetadata":{"title":"Authentication","description":"How to issue an API key and authenticate requests against the Retailgrid Public API.","icon":"key","href":"/api-reference/authentication"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"How to issue an API key and authenticate requests against the Retailgrid Public API.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Retailgrid Public API uses bearer tokens. Each request must include an `,_jsx(_components.code,{children:`Authorization`}),` header with your API key.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer rg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`API keys are prefixed `,_jsx(_components.code,{children:`rg_live_`}),` and are scoped to a single Retailgrid account.`]}),`\n`,_jsx(Heading,{level:`2`,id:`generate-an-api-key`,children:`Generate an API key`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Sign in to `,_jsx(_components.a,{href:`https://app.retailgrid.io`,children:`app.retailgrid.io`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Open `,_jsx(_components.strong,{children:`Settings → Integrations`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Find the `,_jsx(_components.strong,{children:`API access`}),` card and click `,_jsx(_components.strong,{children:`Generate API Key`}),`.`]}),`\n`,_jsx(_components.li,{children:`Copy the key from the modal.`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The key is shown `,_jsx(_components.strong,{children:`only once`}),`, at the moment of creation. Retailgrid does not store the plaintext value, so it cannot be retrieved later. Save it to your secret manager immediately.`]})}),`\n`,_jsxs(_components.p,{children:[`Each account can have `,_jsx(_components.strong,{children:`one active key at a time`}),`. Generating a new key replaces the previous one - existing integrations using the old key will start receiving `,_jsx(_components.code,{children:`401 Unauthorized`}),` and need to be updated.`]}),`\n`,_jsx(Heading,{level:`2`,id:`verify-a-key`,children:`Verify a key`}),`\n`,_jsxs(_components.p,{children:[`The fastest way to check that a key works is to call `,_jsx(_components.code,{children:`GET /v1/auth/verify`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://clientapi.retailgrid.io/v1/auth/verify`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RETAILGRID_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`A successful response confirms the key is valid and tells you which user and key id it belongs to:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"user_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f1c7e0b8-4a2b-4d0e-9a8b-2c3d4e5f6a7b\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"api_key_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"9f1c7e0b-4a2b-4d0e-9a8b-2c3d4e5f6a7b\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`See the full reference on the `,_jsx(_components.a,{href:`/api-reference/auth/verify`,children:`Verify API key`}),` page.`]}),`\n`,_jsx(Heading,{level:`2`,id:`failure-modes`,children:`Failure modes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`401 Unauthorized`})}),_jsx(_components.td,{children:`Header missing, malformed, or the key is no longer active (rotated, revoked, or deleted).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`403 Forbidden`})}),_jsx(_components.td,{children:`Key is valid but does not have access to the requested resource.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`security-guidance`,children:`Security guidance`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Never commit keys to source control.`}),` Use environment variables, a secrets manager, or your CI’s encrypted variables.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Rotate on suspicion.`}),` Generating a new key in the UI immediately invalidates the previous one. There is no separate revoke step.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use a dedicated key per integration`}),` where possible - because each account holds one active key today, plan key rotations to align with deploys of dependent services.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Treat keys like passwords.`}),` A leaked key gives full read/write access to your Retailgrid catalog and transactions.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`need-help`,children:`Need help?`}),`\n`,_jsxs(_components.p,{children:[`If a key stops working unexpectedly or you need a key reset for an account you no longer have UI access to, contact `,_jsx(_components.a,{href:`https://retailgrid.io/contact-us`,children:`support`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{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":{"config":{},"pageMetadata":{"title":"Authentication","description":"How to issue an API key and authenticate requests against the Retailgrid Public API.","icon":"key","href":"/api-reference/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Generate an API key","slug":"generate-an-api-key","depth":2,"children":[]},{"title":"Verify a key","slug":"verify-a-key","depth":2,"children":[]},{"title":"Failure modes","slug":"failure-modes","depth":2,"children":[]},{"title":"Security guidance","slug":"security-guidance","depth":2,"children":[]},{"title":"Need help?","slug":"need-help","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"retailgrid","siteName":"Retailgrid Documentation","title":"Authentication - Retailgrid Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/authentication","matchLevel":0},"es":{"href":"/es/api-reference/authentication","matchLevel":1}}},"lastModified":"2026-07-03T14:59:59.422Z","originalFileLocation":"api-reference/authentication.mdx","locale":"en"},"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=\"How to issue an API key and authenticate requests against the Retailgrid Public API.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Retailgrid Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/retailgrid/Lzc9OAs4ACXUPH8c/_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/retailgrid/Lzc9OAs4ACXUPH8c/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/retailgrid/Lzc9OAs4ACXUPH8c/_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/retailgrid/Lzc9OAs4ACXUPH8c/_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/retailgrid/Lzc9OAs4ACXUPH8c/_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/retailgrid/Lzc9OAs4ACXUPH8c/_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/retailgrid/Lzc9OAs4ACXUPH8c/_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/retailgrid/Lzc9OAs4ACXUPH8c/_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/retailgrid/Lzc9OAs4ACXUPH8c/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - Retailgrid Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"How to issue an API key and authenticate requests against the Retailgrid Public API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Retailgrid Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.retailgrid.io/api-reference/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://retailgrid.mintlify.site/_mintlify/api/og/v2?division=Overview\u0026amp;title=Authentication\u0026amp;description=How+to+issue+an+API+key+and+authenticate+requests+against+the+Retailgrid+Public+API.\u0026amp;theme=1a480a8a742a6ae511e49f25\u0026amp;signature=c511d127aefa66fab90cf784a9339b345f8b5719561fb2ff6a99fa22c5b0a163\">\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=\"Authentication - Retailgrid Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How to issue an API key and authenticate requests against the Retailgrid Public API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://retailgrid.mintlify.site/_mintlify/api/og/v2?division=Overview\u0026amp;title=Authentication\u0026amp;description=How+to+issue+an+API+key+and+authenticate+requests+against+the+Retailgrid+Public+API.\u0026amp;theme=1a480a8a742a6ae511e49f25\u0026amp;signature=c511d127aefa66fab90cf784a9339b345f8b5719561fb2ff6a99fa22c5b0a163\">\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/retailgrid/Lzc9OAs4ACXUPH8c/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Retailgrid Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1E40AF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.retailgrid.io/api-reference/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/authentication.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.retailgrid.io/api-reference/authentication\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.retailgrid.io/es/api-reference/authentication\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.retailgrid.io/api-reference/authentication\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.retailgrid.io/#organization\",\"name\":\"Retailgrid Documentation\",\"url\":\"https://docs.retailgrid.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/retailgrid/OV_G2hLQBJ93ME2e/images/retailgrid-mark-dark-1200.png?fit=max\u0026auto=format\u0026n=OV_G2hLQBJ93ME2e\u0026q=85\u0026s=2b4dca9e40af4b82015237e9abe65e3d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.retailgrid.io#website\",\"name\":\"Retailgrid Documentation\",\"url\":\"https://docs.retailgrid.io\",\"publisher\":{\"@id\":\"https://docs.retailgrid.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.retailgrid.io/api-reference/authentication#webpage\",\"url\":\"https://docs.retailgrid.io/api-reference/authentication\",\"name\":\"Authentication\",\"description\":\"How to issue an API key and authenticate requests against the Retailgrid Public API.\",\"dateModified\":\"2026-07-03T14:59:59.422Z\",\"isPartOf\":{\"@id\":\"https://docs.retailgrid.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.retailgrid.io/api-reference/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.retailgrid.io/api-reference/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Overview\",\"item\":\"https://docs.retailgrid.io/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://docs.retailgrid.io/api-reference/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.retailgrid.io/api-reference/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"How to issue an API key and authenticate requests against the Retailgrid Public API.\",\"url\":\"https://docs.retailgrid.io/api-reference/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://docs.retailgrid.io/api-reference/authentication#webpage\"},\"dateModified\":\"2026-07-03T14:59:59.422Z\",\"publisher\":{\"@id\":\"https://docs.retailgrid.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.retailgrid.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Retailgrid Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Retailgrid Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/authentication.md","siteName":"Retailgrid Documentation","nav":{"global":null,"languages":[{"language":"en","default":true,"anchors":[{"anchor":"Documentation","color":{"light":"#1F4FD8","dark":"#1F4FD8"},"tabs":[{"tab":"Guides","icon":"user","pages":[{"title":"Guides","href":"/get-started/overview"}]},{"tab":"Reference","icon":"book","pages":[{"title":"Reference","href":"/data-requirements/datasets"}]},{"tab":"API","icon":"plug","groups":[{"group":"Overview","public":true,"pages":[{"title":"Introduction","description":"The Retailgrid Public API lets you push and pull product, variant, transaction, and competitor data, plus export full grid contents - programmatically.","icon":"plug","href":"/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"API quickstart","description":"From zero to your first product upserted via the API in under five minutes.","icon":"rocket","href":"/api-reference/quickstart"},{"title":"Conventions","icon":"list-check","href":"/api-reference/conventions"},{"title":"Errors","icon":"triangle-exclamation","href":"/api-reference/errors"},{"title":"Usage \u0026 limits","sidebarTitle":"Usage \u0026 limits","icon":"gauge","href":"/api-reference/usage-limits"},{"title":"Imports vs bulk","icon":"code-compare","href":"/api-reference/imports-vs-bulk"},{"title":"API changelog","icon":"newspaper","href":"/api-reference/changelog"}]},{"group":"Auth","public":true,"pages":[{"title":"Verify API key","openapi":"GET /v1/auth/verify","href":"/api-reference/auth/verify"}]},{"group":"Imports (CSV)","public":true,"pages":[{"title":"Import products CSV","openapi":"POST /v1/imports/products","href":"/api-reference/imports/products"},{"title":"Import transactions CSV","openapi":"POST /v1/imports/transactions","href":"/api-reference/imports/transactions"},{"title":"Import competitor prices CSV","openapi":"POST /v1/imports/competitor_prices","href":"/api-reference/imports/competitor-prices"},{"title":"Import product store CSV","openapi":"POST /v1/imports/product_store","href":"/api-reference/imports/product-store"}]},{"group":"Products","public":true,"pages":[{"title":"List products","api":"GET https://clientapi.retailgrid.io/v1/products","href":"/api-reference/products/list"},{"title":"Bulk upsert products","openapi":"POST /v1/products/bulk","href":"/api-reference/products/bulk-upsert"},{"title":"Create a product","openapi":"POST /v1/products/{entity_id}","href":"/api-reference/products/create"},{"title":"Patch a product","openapi":"PATCH /v1/products/{entity_id}","href":"/api-reference/products/patch"},{"title":"Batch update products","openapi":"PATCH /v1/products/bulk","href":"/api-reference/products/batch-update"},{"title":"Delete a product","openapi":"DELETE /v1/products/{entity_id}","href":"/api-reference/products/delete"}]},{"group":"Product store","public":true,"pages":[{"title":"List product store records","openapi":"GET /v1/product_store","href":"/api-reference/product-store/list"},{"title":"Bulk upsert product store records","openapi":"POST /v1/product_store/bulk","href":"/api-reference/product-store/bulk-upsert"},{"title":"Upsert a product store record","openapi":"POST /v1/product_store","href":"/api-reference/product-store/create"},{"title":"Patch a product store record","openapi":"PATCH /v1/product_store/{entity_id}","href":"/api-reference/product-store/patch"},{"title":"Delete a product store record","openapi":"DELETE /v1/product_store/{entity_id}","href":"/api-reference/product-store/delete"}]},{"group":"Transactions","public":true,"pages":[{"title":"List transactions","api":"GET https://clientapi.retailgrid.io/v1/transactions","href":"/api-reference/transactions/list"},{"title":"Latest transaction","api":"GET https://clientapi.retailgrid.io/v1/transactions/latest","href":"/api-reference/transactions/latest"},{"title":"Bulk upsert transactions","openapi":"POST /v1/transactions/bulk","href":"/api-reference/transactions/bulk-upsert"},{"title":"Create a transaction","openapi":"POST /v1/transactions/{entity_id}","href":"/api-reference/transactions/create"},{"title":"Patch a transaction","openapi":"PATCH /v1/transactions/{entity_id}","href":"/api-reference/transactions/patch"},{"title":"Delete a transaction","openapi":"DELETE /v1/transactions/{entity_id}","href":"/api-reference/transactions/delete"}]},{"group":"Competitor prices","public":true,"pages":[{"title":"Bulk upsert competitor prices","openapi":"POST /v1/competitor_prices/bulk","href":"/api-reference/competitor-prices/bulk-upsert"},{"title":"Create a competitor price","openapi":"POST /v1/competitor_prices","href":"/api-reference/competitor-prices/create"},{"title":"Patch a competitor price","openapi":"PATCH /v1/competitor_prices/{entity_id}","href":"/api-reference/competitor-prices/patch"},{"title":"Delete a competitor price","openapi":"DELETE /v1/competitor_prices/{entity_id}","href":"/api-reference/competitor-prices/delete"}]},{"group":"Matching","public":true,"pages":[{"title":"Publish competitor data to Price Radar","sidebarTitle":"Matching uploads","icon":"list-check","href":"/api-reference/matching/overview"},{"title":"List current matches and review decisions","sidebarTitle":"Current matches","openapi":"GET /v1/matching/matches","href":"/api-reference/matching/list-matches"},{"title":"Create, review and remove matches","sidebarTitle":"Write matches","href":"/api-reference/matching/write-matches"},{"title":"Import raw competitor CSVs","sidebarTitle":"Raw imports","openapi":"POST /v1/matching/raw-imports","href":"/api-reference/matching/raw-import"},{"title":"Publish a matching snapshot","openapi":"POST /v1/matching/matched-snapshots","href":"/api-reference/matching/publish-snapshot"},{"title":"Get matching publish progress","openapi":"GET /v1/matching/jobs/{job_id}/progress","href":"/api-reference/matching/get-progress"}]},{"group":"Grids","public":true,"pages":[{"title":"List grids","api":"GET https://clientapi.retailgrid.io/v1/grids","href":"/api-reference/grids/list"},{"title":"Get grid rows","api":"GET https://clientapi.retailgrid.io/v1/grids/{grid_id}/rows","href":"/api-reference/grids/get-rows"}]},{"group":"Jobs","public":true,"pages":[{"title":"Get job status","openapi":"GET /v1/jobs/{job_id}","href":"/api-reference/jobs/get-status"}]},{"group":"Prices","pages":[{"title":"List approved prices","api":"GET https://clientapi.retailgrid.io/v1/approved_prices","href":"/api-reference/approved-prices/list"}]},{"group":"auth","pages":[{"title":"Verify Api Key","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/auth/verify","href":"/api-reference/auth/verify-api-key"}]},{"group":"imports","pages":[{"title":"Import Products Csv","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/imports/products","href":"/api-reference/imports/import-products-csv"},{"title":"Import Transactions Csv","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/imports/transactions","href":"/api-reference/imports/import-transactions-csv"},{"title":"Import Competitor Prices Csv","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/imports/competitor_prices","href":"/api-reference/imports/import-competitor-prices-csv"},{"title":"Import Product Store Csv","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/imports/product_store","href":"/api-reference/imports/import-product-store-csv"},{"title":"Create Upload","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/uploads","href":"/api-reference/imports/create-upload"},{"title":"Complete Upload","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/uploads/{upload_id}:complete","href":"/api-reference/imports/complete-upload"}]},{"group":"internal-import-events","pages":[{"title":"Raw Dbcsv Imported","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/internal/import-events/raw-dbcsv-imported","href":"/api-reference/internal-import-events/raw-dbcsv-imported"}]},{"group":"products","pages":[{"title":"List Products","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/products","href":"/api-reference/products/list-products"},{"title":"Get Product","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/products/{entity_id}","href":"/api-reference/products/get-product"},{"title":"Create Product","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/products/{entity_id}","href":"/api-reference/products/create-product"},{"title":"Delete Product","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json delete /v1/products/{entity_id}","href":"/api-reference/products/delete-product"},{"title":"Patch Product","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json patch /v1/products/{entity_id}","href":"/api-reference/products/patch-product"},{"title":"Bulk Upsert Products","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/products/bulk","href":"/api-reference/products/bulk-upsert-products"},{"title":"Bulk Patch Products","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json patch /v1/products/bulk","href":"/api-reference/products/bulk-patch-products"}]},{"group":"transaction exports","pages":[{"title":"Start Export","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/transactions/exports","href":"/api-reference/transaction-exports/start-export"},{"title":"Export Status","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/transactions/exports/{export_id}","href":"/api-reference/transaction-exports/export-status"},{"title":"Cancel Export","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/transactions/exports/{export_id}/cancel","href":"/api-reference/transaction-exports/cancel-export"},{"title":"Export Files","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/transactions/exports/{export_id}/files","href":"/api-reference/transaction-exports/export-files"}]},{"group":"transactions","pages":[{"title":"List Transactions","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Latest Transaction","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/transactions/latest","href":"/api-reference/transactions/latest-transaction"},{"title":"Get Transaction","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/transactions/{entity_id}","href":"/api-reference/transactions/get-transaction"},{"title":"Create Transaction","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/transactions/{entity_id}","href":"/api-reference/transactions/create-transaction"},{"title":"Delete Transaction","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json delete /v1/transactions/{entity_id}","href":"/api-reference/transactions/delete-transaction"},{"title":"Patch Transaction","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json patch /v1/transactions/{entity_id}","href":"/api-reference/transactions/patch-transaction"},{"title":"Bulk Upsert Transactions","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/transactions/bulk","href":"/api-reference/transactions/bulk-upsert-transactions"}]},{"group":"competitor_prices","pages":[{"title":"List Competitor Prices","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/competitor_prices","href":"/api-reference/competitor_prices/list-competitor-prices"},{"title":"Create Competitor Price","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/competitor_prices","href":"/api-reference/competitor_prices/create-competitor-price"},{"title":"Observation Stats","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/competitor_prices/stats","href":"/api-reference/competitor_prices/observation-stats"},{"title":"Export Observations","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/competitor_prices/export","href":"/api-reference/competitor_prices/export-observations"},{"title":"Bulk Upsert Competitor Prices","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/competitor_prices/bulk","href":"/api-reference/competitor_prices/bulk-upsert-competitor-prices"},{"title":"Observation Competitors","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/competitor_prices/competitors","href":"/api-reference/competitor_prices/observation-competitors"},{"title":"Get Competitor Price","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/competitor_prices/{entity_id}","href":"/api-reference/competitor_prices/get-competitor-price"},{"title":"Delete Competitor Price","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json delete /v1/competitor_prices/{entity_id}","href":"/api-reference/competitor_prices/delete-competitor-price"},{"title":"Patch Competitor Price","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json patch /v1/competitor_prices/{entity_id}","href":"/api-reference/competitor_prices/patch-competitor-price"},{"title":"Observation History","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/competitor_prices/{entity_id}/history","href":"/api-reference/competitor_prices/observation-history"},{"title":"Observation Version","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/competitor_prices/{entity_id}/versions/{observation_id}","href":"/api-reference/competitor_prices/observation-version"}]},{"group":"approved_prices","pages":[{"title":"List Approved Prices","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/approved_prices","href":"/api-reference/approved_prices/list-approved-prices"},{"title":"Acknowledge Approved Prices","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/approved_prices/acknowledge","href":"/api-reference/approved_prices/acknowledge-approved-prices"},{"title":"Deliver Approved Prices","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/approved_prices/deliveries","href":"/api-reference/approved_prices/deliver-approved-prices"}]},{"group":"product_store","pages":[{"title":"List Product Store","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/product_store","href":"/api-reference/product_store/list-product-store"},{"title":"Upsert Product Store","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/product_store","href":"/api-reference/product_store/upsert-product-store"},{"title":"Get Product Store","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/product_store/{entity_id}","href":"/api-reference/product_store/get-product-store"},{"title":"Delete Product Store","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json delete /v1/product_store/{entity_id}","href":"/api-reference/product_store/delete-product-store"},{"title":"Patch Product Store","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json patch /v1/product_store/{entity_id}","href":"/api-reference/product_store/patch-product-store"},{"title":"Bulk Upsert Product Store","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/product_store/bulk","href":"/api-reference/product_store/bulk-upsert-product-store"}]},{"group":"jobs","pages":[{"title":"Get Job","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/jobs/{job_id}","href":"/api-reference/jobs/get-job"}]},{"group":"matching","pages":[{"title":"Current Review Matches","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/matching/matches","href":"/api-reference/matching/current-review-matches"},{"title":"Publish Matched Snapshot","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/matching/matched-snapshots","href":"/api-reference/matching/publish-matched-snapshot"},{"title":"Matching Job Progress","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/matching/jobs/{job_id}/progress","href":"/api-reference/matching/matching-job-progress"},{"title":"Public Add Matches","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/matching/matches:batch-add","href":"/api-reference/matching/public-add-matches"},{"title":"Public Decide Matches","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/matching/matches:batch-decide","href":"/api-reference/matching/public-decide-matches"},{"title":"Public Remove Matches","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/matching/matches:batch-remove","href":"/api-reference/matching/public-remove-matches"},{"title":"Public Competitor Products","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/matching/competitor-products","href":"/api-reference/matching/public-competitor-products"},{"title":"Import Raw Matches","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json post /v1/matching/raw-imports","href":"/api-reference/matching/import-raw-matches"}]},{"group":"grids","pages":[{"title":"Competitor Item Prices","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/grids/{grid_id}/items/{grid_item_id}/competitor-offers","href":"/api-reference/grids/competitor-item-prices"},{"title":"List Grids","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/grids","href":"/api-reference/grids/list-grids"},{"title":"Export Grid","deprecated":null,"version":null,"openapi":"https://clientapi.retailgrid.io/openapi.json get /v1/grids/{grid_id}","href":"/api-reference/grids/export-grid"}]}]},{"tab":"Changelog","icon":"newspaper","pages":[{"title":"Changelog","href":"/changelog/product-updates"}]}]}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/authentication"}]}]},"basePath":"","title":"Authentication - Retailgrid Documentation","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}