{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Polinate API","colors":{"primary":"#F59E0B","light":"#FBBF24","dark":"#B45309"},"logo":{"light":"https://mintcdn.com/polinatetest/bhlEPsVq_tFaunWn/logo/light.png?fit=max\u0026auto=format\u0026n=bhlEPsVq_tFaunWn\u0026q=85\u0026s=414c7946cbab63b1f5121c26a83b1614","dark":"https://mintlify.s3.us-west-1.amazonaws.com/polinatetest/logo/dark.png"},"favicon":"/favicon.svg","navbar":{"links":[{"label":"Support","href":"mailto:admin@polinate.com.au"}],"primary":{"type":"button","label":"Back to Polinate","href":"https://supplier.polinate.ai"}},"footer":{"socials":{"x":"https://x.com/polinate","github":"https://github.com/polinate","linkedin":"https://linkedin.com/company/polinate"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"polinatetest","hasAudioNarration":false,"actualSubdomain":"polinatetest","customDomains":["docs.polinate.ai"],"gitSource":{"type":"github","owner":"polinater","repo":"monorepo","deployBranch":"master","contentDirectory":"apps/docs-web-app","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20cb3b6bbb46a0adf9758f","collectionId":"e70506d4-a50f-470c-a3e5-73db7abd9435","schemaVersion":"v2"},"feedback":{"issues":true,"thumbs":true,"edits":true},"entitlements":{},"buildId":"6ae93ecea9467e5eaf49f4a1:success","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API reference","count":17},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Orders","count":5},{"language":"default","tag":"Resources","count":4},{"language":"default","tag":"Buyers","count":4},{"language":"default","tag":"Items","count":4},{"language":"default","tag":"Basics","count":3},{"language":"default","tag":"Invoices","count":3},{"language":"default","tag":"Pricing","count":1}]},"assistantConfig":{},"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":"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":"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":"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":"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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/items/get-an-item-by-id","slug":"/api-reference/items/get-an-item-by-id","pageMetadata":{"title":"Get an item by ID","description":"Retrieves a single item by ID including its variants.","deprecated":null,"version":null,"openapi":"openapi.json get /api/v1/items/{id}","href":"/api-reference/items/get-an-item-by-id","autogeneratedByOpenApi":true},"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: \"Retrieves a single item by ID including its variants.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get an item by ID","description":"Retrieves a single item by ID including its variants.","deprecated":null,"version":null,"openapi":"openapi.json get /api/v1/items/{id}","href":"/api-reference/items/get-an-item-by-id","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getItem","summary":"Get an item by ID","description":"Retrieves a single item by ID including its variants.","tags":["Items"],"parameters":["469b1f00-da87-45cb-b867-394dc525645d","5ded8a1e-7a67-4119-a09f-dcb4cede3bba","21066190-f4c8-4d8e-a098-11c40c5aa05b"],"responses":{"200":"251a0771-b063-48bf-b5af-003ffae64497","401":"08d194b7-7075-40bb-98ca-690653eed244","404":"32aafbbb-e85a-4fa1-a7e5-d973ccceb6c5","429":"8b360b0a-9545-48ca-9c26-0753fd43abe6"},"method":"get","type":"path","servers":["c4c410d7-5b7d-4132-9d2e-1d94089efdac"],"security":[],"path":"/api/v1/items/{id}","baseUrlOptions":["https://integrations.polinate.ai"],"title":"Get an item by ID","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"469b1f00-da87-45cb-b867-394dc525645d":{"schema":{"type":"string","example":"itm_123","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"id","in":"path"},"5ded8a1e-7a67-4119-a09f-dcb4cede3bba":{"schema":{"type":"string","description":"Business identifier for external auth. Find in Polinate app → Business Settings → Integrations.","example":"{{businessId}}","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"X-Business-Id","in":"header"},"21066190-f4c8-4d8e-a098-11c40c5aa05b":{"schema":{"type":"string","description":"Per-business API key for external auth. Find in Polinate app → Business Settings → Integrations.","example":"{{apiKey}}","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"X-API-Key","in":"header"}},"responses":{"251a0771-b063-48bf-b5af-003ffae64497":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"handle":{"type":"string","isRequired":true,"uniqueKey":"handle","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"imgUrl":{"oneOf":[{"type":"string","uniqueKey":"imgUrl.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"imgUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"imgUrl","typeLabel":"string | null"},"customType":{"oneOf":[{"type":"string","uniqueKey":"customType.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"customType.oneOf.1","typeLabel":"null"}],"uniqueKey":"customType","typeLabel":"string | null"},"brand":{"oneOf":[{"type":"string","uniqueKey":"brand.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"brand.oneOf.1","typeLabel":"null"}],"uniqueKey":"brand","typeLabel":"string | null"},"vendorName":{"oneOf":[{"type":"string","uniqueKey":"vendorName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"vendorName.oneOf.1","typeLabel":"null"}],"uniqueKey":"vendorName","typeLabel":"string | null"},"type":{"type":"string","uniqueKey":"type","typeLabel":"string"},"status":{"type":"string","uniqueKey":"status","typeLabel":"string"},"properties":{"type":"object","properties":{},"uniqueKey":"properties","typeLabel":"object"},"createdAt":{"type":"string","uniqueKey":"createdAt","typeLabel":"string"},"updatedAt":{"type":"string","uniqueKey":"updatedAt","typeLabel":"string"},"deletedAt":{"oneOf":[{"type":"string","uniqueKey":"deletedAt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"deletedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"deletedAt","typeLabel":"string | null"},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"variants.items.[INDEX].id","typeLabel":"string"},"itemId":{"type":"string","isRequired":true,"uniqueKey":"variants.items.[INDEX].itemId","typeLabel":"string"},"variantName":{"type":"string","isRequired":true,"uniqueKey":"variants.items.[INDEX].variantName","typeLabel":"string"},"sku":{"oneOf":[{"type":"string","uniqueKey":"variants.items.[INDEX].sku.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"variants.items.[INDEX].sku.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].sku","typeLabel":"string | null"},"barcode":{"oneOf":[{"type":"string","uniqueKey":"variants.items.[INDEX].barcode.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"variants.items.[INDEX].barcode.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].barcode","typeLabel":"string | null"},"upc":{"oneOf":[{"type":"string","uniqueKey":"variants.items.[INDEX].upc.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"variants.items.[INDEX].upc.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].upc","typeLabel":"string | null"},"isDefault":{"type":"boolean","uniqueKey":"variants.items.[INDEX].isDefault","typeLabel":"boolean"},"currency":{"type":"string","enum":["USD","EUR","GBP","CAD","AUD","NZD","CHF","JPY","CNY","INR","BRL","MXN","ARS","COP","PHP"],"uniqueKey":"variants.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"price":{"type":"number","uniqueKey":"variants.items.[INDEX].price","typeLabel":"number"},"cost":{"type":"number","uniqueKey":"variants.items.[INDEX].cost","typeLabel":"number"},"weight":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].weight.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].weight.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].weight","typeLabel":"number | null"},"length":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].length.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].length.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].length","typeLabel":"number | null"},"width":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].width.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].width","typeLabel":"number | null"},"height":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].height.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].height","typeLabel":"number | null"},"unitOfMeasure":{"oneOf":[{"type":"string","uniqueKey":"variants.items.[INDEX].unitOfMeasure.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"variants.items.[INDEX].unitOfMeasure.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].unitOfMeasure","typeLabel":"string | null"},"leadTime":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].leadTime.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].leadTime.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].leadTime","typeLabel":"number | null"},"reorderPoint":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].reorderPoint.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].reorderPoint.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].reorderPoint","typeLabel":"number | null"},"reorderQuantity":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].reorderQuantity.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].reorderQuantity.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].reorderQuantity","typeLabel":"number | null"},"inStockQuantity":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].inStockQuantity.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].inStockQuantity.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].inStockQuantity","typeLabel":"number | null"},"onOrderQuantity":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].onOrderQuantity.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].onOrderQuantity.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].onOrderQuantity","typeLabel":"number | null"},"conversionFactor":{"oneOf":[{"type":"number","uniqueKey":"variants.items.[INDEX].conversionFactor.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"variants.items.[INDEX].conversionFactor.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].conversionFactor","typeLabel":"number | null"},"countryOfOrigin":{"oneOf":[{"type":"string","uniqueKey":"variants.items.[INDEX].countryOfOrigin.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"variants.items.[INDEX].countryOfOrigin.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].countryOfOrigin","typeLabel":"string | null"},"hsCode":{"oneOf":[{"type":"string","uniqueKey":"variants.items.[INDEX].hsCode.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"variants.items.[INDEX].hsCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].hsCode","typeLabel":"string | null"},"eccn":{"oneOf":[{"type":"string","uniqueKey":"variants.items.[INDEX].eccn.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"variants.items.[INDEX].eccn.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].eccn","typeLabel":"string | null"},"customsDeclarationInfo":{"oneOf":[{"type":"string","uniqueKey":"variants.items.[INDEX].customsDeclarationInfo.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"variants.items.[INDEX].customsDeclarationInfo.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].customsDeclarationInfo","typeLabel":"string | null"},"sequence":{"type":"number","uniqueKey":"variants.items.[INDEX].sequence","typeLabel":"number"},"properties":{"type":"object","properties":{},"uniqueKey":"variants.items.[INDEX].properties","typeLabel":"object"},"createdAt":{"type":"string","uniqueKey":"variants.items.[INDEX].createdAt","typeLabel":"string"},"updatedAt":{"type":"string","uniqueKey":"variants.items.[INDEX].updatedAt","typeLabel":"string"},"deletedAt":{"oneOf":[{"type":"string","uniqueKey":"variants.items.[INDEX].deletedAt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"variants.items.[INDEX].deletedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"variants.items.[INDEX].deletedAt","typeLabel":"string | null"}},"required":["id","itemId","variantName"],"uniqueKey":"variants.items.[INDEX]","typeLabel":"object"},"uniqueKey":"variants","typeLabel":"object[]"}},"required":["id","name","handle"],"uniqueKey":"","typeLabel":"object"},"example":{"id":"itm_123","name":"Widget","handle":"widget-1","type":"OTHER","status":"ACTIVE","variants":[{"id":"var_small","itemId":"itm_123","variantName":"Small","sku":"SKU-S","currency":"AUD","price":9.99,"cost":5,"weight":0.5,"unitOfMeasure":"kg","sequence":1},{"id":"var_large","itemId":"itm_123","variantName":"Large","sku":"SKU-L","currency":"AUD","price":14.99,"cost":8,"weight":1,"unitOfMeasure":"kg","sequence":2}]},"examples":{"Example":{"title":"Example","value":{"id":"itm_123","name":"Widget","handle":"widget-1","type":"OTHER","status":"ACTIVE","variants":[{"id":"var_small","itemId":"itm_123","variantName":"Small","sku":"SKU-S","currency":"AUD","price":9.99,"cost":5,"weight":0.5,"unitOfMeasure":"kg","sequence":1},{"id":"var_large","itemId":"itm_123","variantName":"Large","sku":"SKU-L","currency":"AUD","price":14.99,"cost":8,"weight":1,"unitOfMeasure":"kg","sequence":2}]}}},"exampleType":"examples"}},"exampleType":"examples"},"08d194b7-7075-40bb-98ca-690653eed244":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"errorCode":{"type":"string","isRequired":true,"uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"fieldErrors.additionalProperties","typeLabel":"string"},"uniqueKey":"fieldErrors","typeLabel":"object"}},"required":["errorCode","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errorCode":"\u003cstring>","message":"\u003cstring>","fieldErrors":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"32aafbbb-e85a-4fa1-a7e5-d973ccceb6c5":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"errorCode":{"type":"string","isRequired":true,"uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"fieldErrors.additionalProperties","typeLabel":"string"},"uniqueKey":"fieldErrors","typeLabel":"object"}},"required":["errorCode","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errorCode":"\u003cstring>","message":"\u003cstring>","fieldErrors":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"8b360b0a-9545-48ca-9c26-0753fd43abe6":{"description":"Rate limited","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errorCode":{"type":"string","isRequired":true,"uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"fieldErrors.additionalProperties","typeLabel":"string"},"uniqueKey":"fieldErrors","typeLabel":"object"}},"required":["errorCode","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errorCode":"\u003cstring>","message":"\u003cstring>","fieldErrors":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"c4c410d7-5b7d-4132-9d2e-1d94089efdac":{"url":"https://integrations.polinate.ai","description":"Production"}}},"originalFileLocation":"openapi.json"},"subdomain":"polinatetest","siteName":"Polinate API","title":"Get an item by ID - Polinate API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-10-19T23:42:48.269Z","originalFileLocation":"api-reference/items/get-an-item-by-id.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieves a single item by ID including its variants.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Polinate API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/polinatetest/gPhIFapkwWMRKp-h/_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/polinatetest/gPhIFapkwWMRKp-h/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/polinatetest/gPhIFapkwWMRKp-h/_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/polinatetest/gPhIFapkwWMRKp-h/_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/polinatetest/gPhIFapkwWMRKp-h/_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/polinatetest/gPhIFapkwWMRKp-h/_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/polinatetest/gPhIFapkwWMRKp-h/_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/polinatetest/gPhIFapkwWMRKp-h/_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/polinatetest/gPhIFapkwWMRKp-h/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get an item by ID - Polinate API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves a single item by ID including its variants.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Polinate API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://polinatetest.mintlify.app/_mintlify/api/og/v2?division=Items\u0026amp;title=Get+an+item+by+ID\u0026amp;description=Retrieves+a+single+item+by+ID+including+its+variants.\u0026amp;theme=4b5ab811bf12be1392b02e94\u0026amp;signature=a3d33b884abc425a67a69fba82dd9b346e06ed937bc68e19518e8310161b2a79\">\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=\"Get an item by ID - Polinate API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves a single item by ID including its variants.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://polinatetest.mintlify.app/_mintlify/api/og/v2?division=Items\u0026amp;title=Get+an+item+by+ID\u0026amp;description=Retrieves+a+single+item+by+ID+including+its+variants.\u0026amp;theme=4b5ab811bf12be1392b02e94\u0026amp;signature=a3d33b884abc425a67a69fba82dd9b346e06ed937bc68e19518e8310161b2a79\">\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/polinatetest/gPhIFapkwWMRKp-h/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Polinate API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F59E0B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/items/get-an-item-by-id.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.polinate.ai/#organization\",\"name\":\"Polinate API\",\"url\":\"https://docs.polinate.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/polinatetest/bhlEPsVq_tFaunWn/logo/light.png?fit=max\u0026auto=format\u0026n=bhlEPsVq_tFaunWn\u0026q=85\u0026s=414c7946cbab63b1f5121c26a83b1614\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.polinate.ai#website\",\"name\":\"Polinate API\",\"url\":\"https://docs.polinate.ai\",\"publisher\":{\"@id\":\"https://docs.polinate.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id#webpage\",\"url\":\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id\",\"name\":\"Get an item by ID\",\"description\":\"Retrieves a single item by ID including its variants.\",\"dateModified\":\"2025-10-19T23:42:48.269Z\",\"isPartOf\":{\"@id\":\"https://docs.polinate.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Items\",\"item\":\"https://docs.polinate.ai/api-reference/items/create-an-item-and-its-variants\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get an item by ID\",\"item\":\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id#apireference\",\"headline\":\"Get an item by ID\",\"name\":\"Get an item by ID\",\"description\":\"Retrieves a single item by ID including its variants.\",\"url\":\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id\",\"mainEntityOfPage\":{\"@id\":\"https://docs.polinate.ai/api-reference/items/get-an-item-by-id#webpage\"},\"dateModified\":\"2025-10-19T23:42:48.269Z\",\"publisher\":{\"@id\":\"https://docs.polinate.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.polinate.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Polinate API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Polinate API","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book","pages":[{"title":"Guides","href":"/guides/authentication"}]},{"tab":"API reference","groups":[{"group":"Items","pages":[{"title":"Create an item and its variants","description":"Create a parent item and its variants in one request. Idempotent via Idempotency-Key.","deprecated":null,"version":null,"openapi":"openapi.json post /api/v1/items","href":"/api-reference/items/create-an-item-and-its-variants"},{"title":"Get an item by ID","deprecated":null,"version":null,"openapi":"openapi.json get /api/v1/items/{id}","href":"/api-reference/items/get-an-item-by-id"},{"title":"Delete an item (soft delete)","description":"Soft deletes an item by setting deletedAt timestamp. The item and its variants are retained but marked as deleted.","deprecated":null,"version":null,"openapi":"openapi.json delete /api/v1/items/{id}","href":"/api-reference/items/delete-an-item-soft-delete"},{"title":"Update an item (partial) and manage variants","deprecated":null,"version":null,"openapi":"openapi.json patch /api/v1/items/{id}","href":"/api-reference/items/update-an-item-partial-and-manage-variants"}]},{"group":"Buyers","pages":[{"title":"Create a buyer (phantom) and related contacts/locations","deprecated":null,"version":null,"openapi":"openapi.json post /api/v1/buyers","href":"/api-reference/buyers/create-a-buyer-phantom-and-related-contactslocations"},{"title":"Get a buyer by ID","deprecated":null,"version":null,"openapi":"openapi.json get /api/v1/buyers/{id}","href":"/api-reference/buyers/get-a-buyer-by-id"},{"title":"Delete a buyer (soft delete)","deprecated":null,"version":null,"openapi":"openapi.json delete /api/v1/buyers/{id}","href":"/api-reference/buyers/delete-a-buyer-soft-delete"},{"title":"Update a buyer (comprehensive CRUD)","deprecated":null,"version":null,"openapi":"openapi.json patch /api/v1/buyers/{id}","href":"/api-reference/buyers/update-a-buyer-comprehensive-crud"}]},{"group":"Pricing","pages":[{"title":"Create a price list and entries","deprecated":null,"version":null,"openapi":"openapi.json post /api/v1/pricing","href":"/api-reference/pricing/create-a-price-list-and-entries"}]},{"group":"Invoices","pages":[{"title":"List invoices","deprecated":null,"version":null,"openapi":"openapi.json get /api/v1/invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Get an invoice by ID","deprecated":null,"version":null,"openapi":"openapi.json get /api/v1/invoices/{id}","href":"/api-reference/invoices/get-an-invoice-by-id"},{"title":"Update an invoice (partial)","deprecated":null,"version":null,"openapi":"openapi.json patch /api/v1/invoices/{id}","href":"/api-reference/invoices/update-an-invoice-partial"}]},{"group":"Orders","pages":[{"title":"List orders","deprecated":null,"version":null,"openapi":"openapi.json get /api/v1/orders","href":"/api-reference/orders/list-orders"},{"title":"Notify system that an order has been created (ingestion)","deprecated":null,"version":null,"openapi":"openapi.json post /api/v1/orders","href":"/api-reference/orders/notify-system-that-an-order-has-been-created-ingestion"},{"title":"Get an order by ID","deprecated":null,"version":null,"openapi":"openapi.json get /api/v1/orders/{id}","href":"/api-reference/orders/get-an-order-by-id"},{"title":"Delete an order (soft delete)","deprecated":null,"version":null,"openapi":"openapi.json delete /api/v1/orders/{id}","href":"/api-reference/orders/delete-an-order-soft-delete"},{"title":"Update an order and manage order items (comprehensive CRUD)","deprecated":null,"version":null,"openapi":"openapi.json patch /api/v1/orders/{id}","href":"/api-reference/orders/update-an-order-and-manage-order-items-comprehensive-crud"}]}]}]},"basePath":"","title":"Get an item by ID - Polinate API","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}