Best practices for integrating with the Base.com API
This portal collects proven best practices for connecting external systems to Base.com via API. It complements the official reference documentation with recommended approaches for common scenarios (order import, inventory handling, connecting your own e-shop as a partner platform), linked directly to the relevant API methods.
API documentation
Full reference of the main Base.com API methods.
Shops API
Documentation for connecting your own e-shop as a partner platform.
If you run into a situation that can’t be solved with the standard API endpoints, or you’re unsure about the right approach, reach out to our implementation team — they can help design and test the integration.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Base.com API Best Practice","colors":{"primary":"#0D6EFD","light":"#4B93FF","dark":"#0A54C4"},"logo":{"light":"https://mintcdn.com/base-37a631cc/wN7xVxE0DXLcz370/logo/light.svg?fit=max\u0026auto=format\u0026n=wN7xVxE0DXLcz370\u0026q=85\u0026s=53f352e5d382c765280f2b28365b899a","dark":"https://mintcdn.com/base-37a631cc/wN7xVxE0DXLcz370/logo/dark.svg?fit=max\u0026auto=format\u0026n=wN7xVxE0DXLcz370\u0026q=85\u0026s=672ce081897b4d7b7949bf74e2b51b45"},"navbar":{"links":[{"href":"https://api.baselinker.com/","label":"API dokumentace"},{"href":"https://developers.baselinker.com/shops_api/","label":"Shops API"}]},"footer":{"links":[{"header":"Zdroje","items":[{"label":"API dokumentace","href":"https://api.baselinker.com/"},{"label":"Shops API dokumentace","href":"https://developers.baselinker.com/shops_api"}]}]},"styling":{"latex":false},"navigation":{"languages":[{"language":"cs","href":"cs"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"base-37a631cc","hasAudioNarration":false,"actualSubdomain":"base-37a631cc","customDomains":["api.basetools.cz"],"gitSource":{"type":"github","owner":"jhavlicekbl","repo":"base-api-best-practice","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"7f4170b4-9a18-4dfa-a582-d91f19b0aaf2","liveDeploymentHistoryId":"6a4d085c5aeac46d212ddbfd","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a4d085c5aeac46d212ddbfd:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"cs","tag":"Objednávky","count":7},{"language":"en","tag":"Orders","count":7},{"language":"cs","tag":"Produkty","count":4},{"language":"en","tag":"Products","count":4},{"language":"cs","tag":"Partnerství a Shops API","count":2},{"language":"en","tag":"Partnership \u0026 Shops API","count":2},{"language":"cs","tag":"Base Analytics","count":1},{"language":"cs","tag":"Začínáme","count":1},{"language":"cs","tag":"Vratky","count":1},{"language":"en","tag":"Base Analytics","count":1},{"language":"en","tag":"Getting started","count":1},{"language":"en","tag":"Returns","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"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":"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":"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":"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":"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":"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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en","slug":"/en","pageMetadata":{"title":"Introduction","description":"Best practices for integrating with the Base.com API","href":"/en/index"},"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: \"Best practices for integrating with the Base.com 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={p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This portal collects proven best practices for connecting external systems to Base.com via API. It complements the official reference documentation with recommended approaches for common scenarios (order import, inventory handling, connecting your own e-shop as a partner platform), linked directly to the relevant API methods.`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`API documentation`,icon:`book`,href:`https://api.baselinker.com/`,children:_jsx(_components.p,{children:`Full reference of the main Base.com API methods.`})}),_jsx(Card,{title:`Shops API`,icon:`store`,href:`https://developers.baselinker.com/shops_api/`,children:_jsx(_components.p,{children:`Documentation for connecting your own e-shop as a partner platform.`})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`If you run into a situation that can’t be solved with the standard API endpoints, or you’re unsure about the right approach, reach out to our `,_jsx(_components.strong,{children:`implementation team`}),` — they can help design and test the integration.`]})})]})}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":"Introduction","description":"Best practices for integrating with the Base.com API","href":"/en/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"base-37a631cc","siteName":"Base.com API Best Practice","title":"Introduction - Base.com API Best Practice","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"cs":{"href":"/cs","matchLevel":1},"en":{"href":"/en","matchLevel":0}}},"lastModified":"2026-07-05T07:33:01.324Z","originalFileLocation":"en/index.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=\"Best practices for integrating with the Base.com API\">\u003cmeta data-mint-head name=\"application-name\" content=\"Base.com API Best Practice\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/base-37a631cc/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/base-37a631cc/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/base-37a631cc/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/base-37a631cc/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Introduction - Base.com API Best Practice\">\u003cmeta data-mint-head property=\"og:description\" content=\"Best practices for integrating with the Base.com API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Base.com API Best Practice\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api.basetools.cz/en\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://base-37a631cc.mintlify.app/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Introduction\u0026amp;description=Best+practices+for+integrating+with+the+Base.com+API\u0026amp;theme=d8a22a30e44ccb38ea5389d7\u0026amp;signature=da87fd261e58290dc654307f30ac21e71e1113ecb134d92bf13003b960fee0c0\">\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=\"Introduction - Base.com API Best Practice\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Best practices for integrating with the Base.com API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://base-37a631cc.mintlify.app/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Introduction\u0026amp;description=Best+practices+for+integrating+with+the+Base.com+API\u0026amp;theme=d8a22a30e44ccb38ea5389d7\u0026amp;signature=da87fd261e58290dc654307f30ac21e71e1113ecb134d92bf13003b960fee0c0\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/base-37a631cc/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Base.com API Best Practice\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D6EFD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api.basetools.cz/en\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://api.basetools.cz/en\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"cs\" href=\"https://api.basetools.cz/cs\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://api.basetools.cz/cs\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api.basetools.cz/#organization\",\"name\":\"Base.com API Best Practice\",\"url\":\"https://api.basetools.cz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/base-37a631cc/wN7xVxE0DXLcz370/logo/light.svg?fit=max\u0026auto=format\u0026n=wN7xVxE0DXLcz370\u0026q=85\u0026s=53f352e5d382c765280f2b28365b899a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api.basetools.cz#website\",\"name\":\"Base.com API Best Practice\",\"url\":\"https://api.basetools.cz\",\"publisher\":{\"@id\":\"https://api.basetools.cz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api.basetools.cz/en#webpage\",\"url\":\"https://api.basetools.cz/en\",\"name\":\"Introduction\",\"description\":\"Best practices for integrating with the Base.com API\",\"dateModified\":\"2026-07-05T07:33:01.324Z\",\"isPartOf\":{\"@id\":\"https://api.basetools.cz#website\"},\"breadcrumb\":{\"@id\":\"https://api.basetools.cz/en#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api.basetools.cz/en#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://api.basetools.cz/en/index\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introduction\",\"item\":\"https://api.basetools.cz/en\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://api.basetools.cz/en#article\",\"headline\":\"Introduction\",\"name\":\"Introduction\",\"description\":\"Best practices for integrating with the Base.com API\",\"url\":\"https://api.basetools.cz/en\",\"mainEntityOfPage\":{\"@id\":\"https://api.basetools.cz/en#webpage\"},\"dateModified\":\"2026-07-05T07:33:01.324Z\",\"publisher\":{\"@id\":\"https://api.basetools.cz/#organization\"},\"isPartOf\":{\"@id\":\"https://api.basetools.cz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Base.com API Best Practice\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Base.com API Best Practice","nav":{"global":null,"languages":[{"language":"cs","pages":[{"title":"cs","href":"/cs"}]},{"language":"en","groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/en"}]},{"group":"Orders","pages":[{"title":"Basic principles","description":"What an order in Base is, where it comes from, and how its lifecycle works","href":"/en/objednavky/zakladni-principy"},{"title":"Downloading orders — getOrders","href":"/en/objednavky/stahovani-objednavek"},{"title":"Statuses","href":"/en/objednavky/statusy"},{"title":"Shipping labels and tracking numbers","href":"/en/objednavky/prepravni-stitky"},{"title":"Working with invoices","href":"/en/objednavky/faktury"},{"title":"Extra fields","href":"/en/objednavky/extra-pole"},{"title":"Automation and webhooks","href":"/en/objednavky/automatizace-a-webhooky"}]},{"group":"Returns","pages":[{"title":"Downloading returns","href":"/en/vratky/stahovani-vratek"}]},{"group":"Products","pages":[{"title":"Basic principles","href":"/en/produkty/zakladni-principy"},{"title":"Uploading product data","href":"/en/produkty/nahrani-produktovych-dat"},{"title":"Updating prices and stock","href":"/en/produkty/aktualizace-cen-a-skladu"},{"title":"Categories, manufacturers and tags","href":"/en/produkty/kategorie-a-vyrobci"}]},{"group":"Base Analytics","pages":[{"title":"Basic principles","href":"/en/base-analytics/zakladni-principy"}]},{"group":"Partnership \u0026 Shops API","pages":[{"title":"Connecting as a partner platform (Shops API)","href":"/en/partnerstvi-shops-api/jak-se-napojit"},{"title":"Becoming an official integration","href":"/en/partnerstvi-shops-api/aktivace-integrace"}]}]}]},"basePath":"","title":"Introduction - Base.com API Best Practice","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}