UUID of a merchant shipping address. Defaults to the merchant's default shipping address if not provided. Retrieve available addresses via the List Merchant Addresses endpoint.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Unbridaled Developer Hub","colors":{"primary":"#9563FF","light":"#AE87FF","dark":"#0D001D"},"logo":{"light":"https://mintcdn.com/unbridaled/DSmz57bAj0BM8SXg/logo/light.svg?fit=max\u0026auto=format\u0026n=DSmz57bAj0BM8SXg\u0026q=85\u0026s=d023a18380556ff4aaeccbfd6e1921e2","dark":"https://mintcdn.com/unbridaled/DSmz57bAj0BM8SXg/logo/dark.svg?fit=max\u0026auto=format\u0026n=DSmz57bAj0BM8SXg\u0026q=85\u0026s=b26b72ddad85467da63bc94ff02062ea"},"favicon":"https://mintcdn.com/unbridaled/DSmz57bAj0BM8SXg/ub-favicon.png?fit=max\u0026auto=format\u0026n=DSmz57bAj0BM8SXg\u0026q=85\u0026s=9761c736f6bba926fe16465309ff3161","background":{"color":{"dark":"#090014"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.unbridaled.ai"}},"footer":{"socials":{"twitter":"https://twitter.com/unbridaled_ai","github":"https://github.com/unbridaled","linkedin":"https://www.linkedin.com/company/unbridaled-ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"unbridaled","hasAudioNarration":false,"actualSubdomain":"unbridaled","customDomains":["developers.unbridaled.ai"],"gitSource":{"type":"github","owner":"unbridaled","repo":"mintlify-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a739eef91c5a3b364361d45","collectionId":"36909d54-e31e-4c93-a8d2-cef3eb138ce1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a739eef91c5a3b364361d45"},"entitlements":{},"buildId":"6a739eef91c5a3b364361d45:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Documentation","count":36},{"language":"default","tag":"API Reference","count":36},{"language":"default","tag":"Defaults","count":10},{"language":"default","tag":"Orders","count":6},{"language":"default","tag":"Diamonds","count":5},{"language":"default","tag":"Profit Margins","count":4},{"language":"default","tag":"Inventory","count":2},{"language":"default","tag":"Merchant Addresses","count":2},{"language":"default","tag":"Merchant Templates","count":2},{"language":"default","tag":"Product Variants","count":2}]},"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":"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":"api-reference/v3/orders/place-order","slug":"/api-reference/v3/orders/place-order","pageMetadata":{"openapi":"post /api/v3/orders/place","title":"Place Order","description":"Place an order by specifying skus and quantities.\n\n## Returns\n\nReturns an `Order` object if successful.","href":"/api-reference/v3/orders/place-order"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n h2: \"h2\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Place an order by specifying skus and quantities.\"\n }), \"\\n\", _jsx(_components.h2, {\n children: \"Returns\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Returns an \", _jsx(_components.code, {\n children: \"Order\"\n }), \" object if successful.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /api/v3/orders/place","title":"Place Order","description":"Place an order by specifying skus and quantities.\n\n## Returns\n\nReturns an `Order` object if successful.","href":"/api-reference/v3/orders/place-order"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Orders"],"summary":"Place Order","description":"Place an order by specifying skus and quantities.\n\n## Returns\n\nReturns an `Order` object if successful.","requestBody":"a26bcef7-a525-4d18-9c17-fce5013b4597","parameters":[],"responses":{"200":"a8d2bf26-85e5-47f3-bd1c-2b3ce64d6ba5"},"method":"post","type":"path","servers":["39d3dfe0-00de-411f-93fb-df6d227984e7","a9ab9bb5-7ffd-4d53-9f9f-039701667d4d"],"security":["94968659-f772-404e-8c1e-0c5cced6fb6d"],"path":"/api/v3/orders/place","baseUrlOptions":["https://api-staging.unbridaled.ai","https://api.unbridaled.ai"],"title":"Place Order","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"line_items":{"type":"array","description":"Array of LineItem objects","items":{"type":"object","properties":{"sku":{"type":"string","description":"SKU of the product","isRequired":true,"uniqueKey":"line_items.items.[INDEX].sku","typeLabel":"string"},"quantity":{"type":"integer","description":"Quantity to order for this line item","isRequired":true,"uniqueKey":"line_items.items.[INDEX].quantity","typeLabel":"integer"}},"required":["sku","quantity"],"uniqueKey":"line_items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"line_items","typeLabel":"object[]"},"order_type":{"type":"string","description":"Type of order.","enum":["invoice","memo"],"isRequired":true,"uniqueKey":"order_type","typeLabel":"enum\u003cstring>"},"external_order_id":{"type":"string","description":"The order ID or order number from Shopify or other ecommerce platforms, used to link orders between systems. Must be unique per merchant per order.","isRequired":true,"uniqueKey":"external_order_id","typeLabel":"string"},"order_reference":{"type":"string","description":"A friendly order reference sent to the end customer by Shopify or other ecommerce platforms. Must be unique per merchant per order.","uniqueKey":"order_reference","typeLabel":"string"},"notes":{"type":"string","description":"Custom notes on the order","uniqueKey":"notes","typeLabel":"string"},"shipping_address_id":{"type":"string","format":"uuid","description":"UUID of a merchant shipping address. Defaults to the merchant's default shipping address if not provided. Retrieve available addresses via the List Merchant Addresses endpoint.","uniqueKey":"shipping_address_id","typeLabel":"string\u003cuuid>"}},"required":["line_items","order_type","external_order_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"CreateOrderRequest":{"title":"CreateOrderRequest","value":{"order_type":"invoice","order_reference":"999917","external_order_id":"777717","line_items":[{"sku":"UB1E29776FA7","quantity":1}]}}},"exampleType":"examples"}},"description":"","exampleType":"examples"},"responses":{"a8d2bf26-85e5-47f3-bd1c-2b3ce64d6ba5":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"uuid":{"type":"string","uniqueKey":"uuid","typeLabel":"string"},"order_type":{"type":"string","uniqueKey":"order_type","typeLabel":"string"},"merchant_uuid":{"type":"string","uniqueKey":"merchant_uuid","typeLabel":"string"},"order_reference":{"type":"string","uniqueKey":"order_reference","typeLabel":"string"},"order_id":{"type":"string","uniqueKey":"order_id","typeLabel":"string"},"fulfillment_status":{"oneOf":[{"type":"string","uniqueKey":"fulfillment_status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"fulfillment_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"fulfillment_status","typeLabel":"string | null"},"payment_status":{"oneOf":[{"type":"string","uniqueKey":"payment_status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"payment_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"payment_status","typeLabel":"string | null"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","uniqueKey":"line_items.items.[INDEX].sku","typeLabel":"string"},"quantity":{"type":"integer","uniqueKey":"line_items.items.[INDEX].quantity","typeLabel":"integer"},"price":{"type":"number","uniqueKey":"line_items.items.[INDEX].price","typeLabel":"number"}},"uniqueKey":"line_items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"line_items","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"uuid":"973c4c41-ce72-42c5-b184-3f0d8d4bb1af","billing_address":{"address_1":"820 Innes Ave.","address_2":"","city":"San Francisco","country_code":"USA","postal_code":"94124","region":"CA"},"fulfillments":[],"line_items":[{"created_on":"2021-12-15T17:53:29.091914+00:00","description":"","fulfilled_quantity":0,"fulfillment_status":null,"name":"Gem UB1E29776FA7","position":0,"price":1.625,"product_type":"gem","quantity":1,"sku":"UB1E29776FA7","uuid":"f1131af3-50ef-42b9-a577-e8cb0a07e1f3"}],"merchant_uuid":"419c61fa-e674-414a-a1e2-7c5270ed9668","notes":"","order_reference":"9999171","external_order_id":"7777171","order_type":"invoice","ordered_on":"2021-12-15T17:57:09.046284+00:00","payment_status":null,"fulfillment_status":null},"examples":{"Example":{"title":"Example","value":{"uuid":"973c4c41-ce72-42c5-b184-3f0d8d4bb1af","billing_address":{"address_1":"820 Innes Ave.","address_2":"","city":"San Francisco","country_code":"USA","postal_code":"94124","region":"CA"},"fulfillments":[],"line_items":[{"created_on":"2021-12-15T17:53:29.091914+00:00","description":"","fulfilled_quantity":0,"fulfillment_status":null,"name":"Gem UB1E29776FA7","position":0,"price":1.625,"product_type":"gem","quantity":1,"sku":"UB1E29776FA7","uuid":"f1131af3-50ef-42b9-a577-e8cb0a07e1f3"}],"merchant_uuid":"419c61fa-e674-414a-a1e2-7c5270ed9668","notes":"","order_reference":"9999171","external_order_id":"7777171","order_type":"invoice","ordered_on":"2021-12-15T17:57:09.046284+00:00","payment_status":null,"fulfillment_status":null}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"94968659-f772-404e-8c1e-0c5cced6fb6d":{"apikeyAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"39d3dfe0-00de-411f-93fb-df6d227984e7":{"url":"https://api-staging.unbridaled.ai","description":"Sandbox API"},"a9ab9bb5-7ffd-4d53-9f9f-039701667d4d":{"description":"Production API","url":"https://api.unbridaled.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apikeyAuth","name":"Authorization"}],"title":"apikeyAuth"}]},"originalFileLocation":"openapi/openapi-v3.yml"},"subdomain":"unbridaled","siteName":"Unbridaled Developer Hub","title":"Place Order - Unbridaled Developer Hub","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference/v2/orders/place-order","matchLevel":1},"v3":{"href":"/api-reference/v3/orders/place-order","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-07-02T21:51:09.769Z","originalFileLocation":"api-reference/v3/orders/place-order.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=\"Place an order by specifying skus and quantities. ## Returns Returns an Order object if successful.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Unbridaled Developer Hub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_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/unbridaled/Qmey59l3eev3zfik/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_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/unbridaled/Qmey59l3eev3zfik/_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/unbridaled/Qmey59l3eev3zfik/_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/unbridaled/Qmey59l3eev3zfik/_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/unbridaled/Qmey59l3eev3zfik/_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/unbridaled/Qmey59l3eev3zfik/_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/unbridaled/Qmey59l3eev3zfik/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Place Order - Unbridaled Developer Hub\">\u003cmeta data-mint-head property=\"og:description\" content=\"Place an order by specifying skus and quantities. ## Returns Returns an Order object if successful.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Unbridaled Developer Hub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://unbridaled.mintlify.app/_mintlify/api/og/v2?division=Orders\u0026amp;title=Place+Order\u0026amp;description=Place+an+order+by+specifying+skus+and+quantities.%0A%0A%23%23+Returns%0A%0AReturns+an+%60Order%60+object+if+successful.\u0026amp;theme=065f12a462b0d0bfb61c33c7\u0026amp;signature=283d2249e397d28f6ea563e62a4aa0a10a68be105bf6a45c875118b90df618a9\">\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=\"Place Order - Unbridaled Developer Hub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Place an order by specifying skus and quantities. ## Returns Returns an Order object if successful.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://unbridaled.mintlify.app/_mintlify/api/og/v2?division=Orders\u0026amp;title=Place+Order\u0026amp;description=Place+an+order+by+specifying+skus+and+quantities.%0A%0A%23%23+Returns%0A%0AReturns+an+%60Order%60+object+if+successful.\u0026amp;theme=065f12a462b0d0bfb61c33c7\u0026amp;signature=283d2249e397d28f6ea563e62a4aa0a10a68be105bf6a45c875118b90df618a9\">\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/unbridaled/Qmey59l3eev3zfik/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Unbridaled Developer Hub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9563FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v3/orders/place-order.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.unbridaled.ai/#organization\",\"name\":\"Unbridaled Developer Hub\",\"url\":\"https://developers.unbridaled.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/unbridaled/DSmz57bAj0BM8SXg/logo/light.svg?fit=max\u0026auto=format\u0026n=DSmz57bAj0BM8SXg\u0026q=85\u0026s=d023a18380556ff4aaeccbfd6e1921e2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.unbridaled.ai#website\",\"name\":\"Unbridaled Developer Hub\",\"url\":\"https://developers.unbridaled.ai\",\"publisher\":{\"@id\":\"https://developers.unbridaled.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order#webpage\",\"url\":\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order\",\"name\":\"Place Order\",\"description\":\"Place an order by specifying skus and quantities. ## Returns Returns an Order object if successful.\",\"dateModified\":\"2026-07-02T21:51:09.769Z\",\"isPartOf\":{\"@id\":\"https://developers.unbridaled.ai#website\"},\"breadcrumb\":{\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Unbridaled Developer Hub\",\"item\":\"https://developers.unbridaled.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Place Order\",\"item\":\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order#apireference\",\"headline\":\"Place Order\",\"name\":\"Place Order\",\"description\":\"Place an order by specifying skus and quantities. ## Returns Returns an Order object if successful.\",\"url\":\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order\",\"mainEntityOfPage\":{\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/orders/place-order#webpage\"},\"dateModified\":\"2026-07-02T21:51:09.769Z\",\"publisher\":{\"@id\":\"https://developers.unbridaled.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.unbridaled.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Unbridaled Developer Hub\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Unbridaled Developer Hub","nav":{"global":null,"versions":[{"version":"v2","pages":[{"title":"v2","href":"/api-reference/v2/orders/place-order"}]},{"version":"v3","anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"API Reference","groups":[{"group":"Diamonds","pages":[{"openapi":"post /api/v3/diamonds/merchant_search","title":"Merchant Search Diamonds","href":"/api-reference/v3/diamonds/merchant-search-diamonds"},{"openapi":"post /api/v3/diamonds/get_diamonds_by_merchant_templates","title":"Diamonds AI Search","href":"/api-reference/v3/diamonds/diamonds-ai-search"},{"openapi":"get /api/v3/diamonds/get_parcel_filters","title":"Get Melee Parcel Filters","href":"/api-reference/v3/diamonds/get-melee-parcel-filters"}]},{"group":"Gemstones","pages":[{"openapi":"get /api/v3/gemstones/get_calibrated_filters","title":"Get Calibrated Gemstone Filters","href":"/api-reference/v3/gemstones/get-calibrated-gemstone-filters"}]},{"group":"Inventory","pages":[{"openapi":"get /api/v3/diamonds/{sku}/is_in_stock","title":"Is Diamond In Stock","description":"Check whether a diamond SKU is currently in stock (quantity > 0).\n\n**No authentication required** — this is a public endpoint.","href":"/api-reference/v3/inventory/is-diamond-in-stock"}]},{"group":"Orders","pages":[{"openapi":"post /api/v3/orders/place","title":"Place Order","href":"/api-reference/v3/orders/place-order"},{"openapi":"get /api/v3/orders/list","title":"List Orders","description":"List Orders.\n\n## Returns\n\nAn object with `orders`, `total`, `offset`, and `limit` fields.","href":"/api-reference/v3/orders/list-orders"},{"openapi":"get /api/v3/orders/search","title":"Search Orders","href":"/api-reference/v3/orders/search-orders"}]},{"group":"Product Variants","pages":[{"openapi":"post /api/v3/product_variants/watches/query","title":"Query Watch Variants","href":"/api-reference/v3/product-variants/query-watch-variants"},{"openapi":"post /api/v3/product_variants/jewelry/query","title":"Query Jewelry Variants","href":"/api-reference/v3/product-variants/query-jewelry-variants"}]},{"group":"Products","pages":[{"openapi":"post /api/v3/products/query","title":"Query Products","href":"/api-reference/v3/products/query-products"},{"openapi":"post /api/v3/products/jewelry/query","title":"Query Jewelry Products","href":"/api-reference/v3/products/query-jewelry-products"}]},{"group":"Merchant Templates","pages":[{"openapi":"get /api/v3/merchant_templates/list","title":"List Merchant Templates","href":"/api-reference/v3/merchant-templates/list-merchant-templates"}]},{"group":"Merchant Addresses","pages":[{"openapi":"get /api/v3/merchant_addresses/list","title":"List Merchant Addresses","href":"/api-reference/v3/merchant-addresses/list-merchant-addresses"}]},{"group":"Profit Margins","pages":[{"openapi":"get /api/v3/profit_margins/{uuid}","title":"Get Profit Margin","href":"/api-reference/v3/profit-margins/get-profit-margin"},{"openapi":"get /api/v3/profit_margins/list","title":"List Profit Margins","href":"/api-reference/v3/profit-margins/list-profit-margins"}]},{"group":"Defaults","pages":[{"openapi":"get /api/v3/defaults/gem_ratios","title":"Get Default Gem Ratios","href":"/api-reference/v3/defaults/get-default-gem-ratios"},{"openapi":"get /api/v3/defaults/gem_attributes","title":"Get Default Gem Attributes","href":"/api-reference/v3/defaults/get-default-gem-attributes"},{"openapi":"get /api/v3/defaults/profit_margins","title":"Get Default Profit Margins","href":"/api-reference/v3/defaults/get-default-profit-margins"},{"openapi":"get /api/v3/defaults/collections","title":"Get Default Collections","href":"/api-reference/v3/defaults/get-default-collections"},{"openapi":"get /api/v3/defaults/merchant_templates","title":"Get Default Merchant Templates","href":"/api-reference/v3/defaults/get-default-merchant-templates"}]}]}]},{"anchor":"Developer Sandbox","icon":"code","href":"https://app-staging.unbridaled.ai"},{"anchor":"Community","icon":"slack","href":"https://join.slack.com/t/unbridaled/shared_invite/zt-1z8nxnj9e-qRerRZJ0lXknTGcuYKbMjw"}]}]},"basePath":"","title":"Place Order - Unbridaled Developer Hub","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}