You can calculate the total price for an order batch before you create it, given a cart, recipients, and send method. To use a specific address, pass the direct_send send method.
The method for sending a order batch. email_and_link sends a gift email to the recipient (specify email for each recipient). link_multiple_custom_list generates a gift link without an automatic email. direct_send ships the product directly to the recipient (specify mailing_address for each recipient). For more information, see Send Methods.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Goody Developers","description":"Build on Goody: send gifts and physical products programmatically with the Goody API, or gift in natural language from Claude and other AI assistants with the Goody MCP server.","colors":{"primary":"#9159D6","light":"#B584F1","dark":"#9159D6"},"logo":{"light":"https://mintcdn.com/goody/UtvUnxw3LhFrdzGW/logo.svg?fit=max\u0026auto=format\u0026n=UtvUnxw3LhFrdzGW\u0026q=85\u0026s=271862d59190ae3cec0a504caf00f0dc","dark":"https://mintcdn.com/goody/UtvUnxw3LhFrdzGW/logo.svg?fit=max\u0026auto=format\u0026n=UtvUnxw3LhFrdzGW\u0026q=85\u0026s=271862d59190ae3cec0a504caf00f0dc"},"favicon":"https://mintcdn.com/goody/UtvUnxw3LhFrdzGW/favicon.png?fit=max\u0026auto=format\u0026n=UtvUnxw3LhFrdzGW\u0026q=85\u0026s=974bb2155b182f71382074bbbd8d109c","api":{"openapi":"goody-api-openapi.json","mdx":{"auth":{"method":"bearer"},"server":"https://api.ongoody.com"}},"navbar":{"links":[{"href":"https://www.ongoody.com/plus/organization/api/commerce","label":"Commerce API Keys"},{"href":"https://www.ongoody.com/plus/organization/api/automation","label":"Automation API Keys"}]},"footer":{"socials":{"twitter":"https://twitter.com/goodygifting","linkedin":"https://www.linkedin.com/company/ongoody","instagram":"https://instagram.com/ongoody"}},"seo":{"metatags":{"og:site_name":"Goody Developers","twitter:card":"summary_large_image","keywords":"Goody API, Goody MCP server, gifting API, gift API, MCP server, send gifts with AI, Claude gifting connector, business gifting, autogift"}},"integrations":{"ga4":{"measurementId":"G-7CST37MNCX"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"goody","hasAudioNarration":false,"actualSubdomain":"goody","customDomains":["developer.ongoody.com"],"gitSource":{"type":"github","owner":"mark-goody","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac7a8825b1873d75a499d88","collectionId":"f8a426a1-1ab1-423e-bb23-3c796a6f3de8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac7a8825b1873d75a499d88"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ac7a8825b1873d75a499d88","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Schemas","count":46},{"language":"default","tag":"API Reference","count":44},{"language":"default","tag":"Documentation","count":38},{"language":"default","tag":"MCP Reference","count":31},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Events","count":10},{"language":"default","tag":"Commerce API","count":8},{"language":"default","tag":"Automation API","count":7},{"language":"default","tag":"Send \u0026 track gifts","count":7},{"language":"default","tag":"Order Batches","count":6}]},"assistantConfig":{},"hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/order-batches/calculate-the-price-for-an-order-batch","slug":"/api-reference/order-batches/calculate-the-price-for-an-order-batch","pageMetadata":{"openapi":"POST /v1/order_batches/price","title":"Calculate the price for an order batch","description":null,"href":"/api-reference/order-batches/calculate-the-price-for-an-order-batch"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`You can calculate the total price for an order batch before you create it, given a cart, recipients, and send method. To use a specific address, pass the `,_jsx(_components.code,{children:`direct_send`}),` send method.`]})}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 /v1/order_batches/price","title":"Calculate the price for an order batch","description":null,"href":"/api-reference/order-batches/calculate-the-price-for-an-order-batch"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Calculate the price for an order batch","tags":["Order Batches"],"security":["43b535e3-0250-4f7f-a282-3f9000cb898a"],"parameters":[],"responses":{"200":"8f180710-31de-4ffc-91b5-47360faa6943","400":"a994af85-460a-47d5-b798-c45811baecc1"},"requestBody":"cc2201c2-6b9f-4870-b4a5-f5ca62f9e884","method":"post","type":"path","servers":["4a853b92-1c76-4ffd-85bf-5a5539f2953d","dd210492-7675-40b8-833a-2901e08fdf59"],"path":"/v1/order_batches/price","baseUrlOptions":["https://api.ongoody.com","https://api.sandbox.ongoody.com"],"title":"Calculate the price for an order batch","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Input parameters for an order batch price calculation.","properties":{"recipients":{"type":"array","items":{"type":"object","properties":{"first_name":{"type":"string","isRequired":true,"uniqueKey":"recipients.items.[INDEX].first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"recipients.items.[INDEX].last_name","typeLabel":"string"},"email":{"type":"string","uniqueKey":"recipients.items.[INDEX].email","typeLabel":"string"},"phone":{"oneOf":[{"type":"string","description":"Optional. Phone number for text notifications. E164 format (e.g. +15552347890), US only.","uniqueKey":"recipients.items.[INDEX].phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional. Phone number for text notifications. E164 format (e.g. +15552347890), US only.","uniqueKey":"recipients.items.[INDEX].phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"recipients.items.[INDEX].phone","typeLabel":"string | null"},"mailing_address":{"type":"object","properties":{"address_1":{"type":"string","isRequired":true,"uniqueKey":"recipients.items.[INDEX].mailing_address.address_1","typeLabel":"string"},"city":{"type":"string","isRequired":true,"uniqueKey":"recipients.items.[INDEX].mailing_address.city","typeLabel":"string"},"state":{"type":"string","isRequired":true,"uniqueKey":"recipients.items.[INDEX].mailing_address.state","typeLabel":"string"},"postal_code":{"type":"string","isRequired":true,"uniqueKey":"recipients.items.[INDEX].mailing_address.postal_code","typeLabel":"string"},"country":{"oneOf":[{"type":"string","description":"The two-letter country code, e.g. \"US\". Only US is supported at this time.","isRequired":true,"uniqueKey":"recipients.items.[INDEX].mailing_address.country.oneOf.0","typeLabel":"string"},{"type":"null","description":"The two-letter country code, e.g. \"US\". Only US is supported at this time.","isRequired":true,"uniqueKey":"recipients.items.[INDEX].mailing_address.country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"recipients.items.[INDEX].mailing_address.country","typeLabel":"string | null"},"first_name":{"oneOf":[{"type":"string","uniqueKey":"recipients.items.[INDEX].mailing_address.first_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"recipients.items.[INDEX].mailing_address.first_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"recipients.items.[INDEX].mailing_address.first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","uniqueKey":"recipients.items.[INDEX].mailing_address.last_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"recipients.items.[INDEX].mailing_address.last_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"recipients.items.[INDEX].mailing_address.last_name","typeLabel":"string | null"},"address_2":{"oneOf":[{"type":"string","uniqueKey":"recipients.items.[INDEX].mailing_address.address_2.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"recipients.items.[INDEX].mailing_address.address_2.oneOf.1","typeLabel":"null"}],"uniqueKey":"recipients.items.[INDEX].mailing_address.address_2","typeLabel":"string | null"}},"required":["address_1","city","state","postal_code","country"],"description":"Optional mailing address to pre-populate into the order. This field is only available for approved API partners.","uniqueKey":"recipients.items.[INDEX].mailing_address","typeLabel":"object"}},"required":["first_name"],"uniqueKey":"recipients.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"recipients","typeLabel":"object[]"},"cart":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"oneOf":[{"type":"string","format":"uuid","description":"ID of the product. Preferred over URL since this is always stable. Either `product_id` or `product_url` must be provided.","isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].product_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"ID of the product. Preferred over URL since this is always stable. Either `product_id` or `product_url` must be provided.","isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].product_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].product_id","typeLabel":"string\u003cuuid> | null"},"quantity":{"type":"integer","isRequired":true,"uniqueKey":"cart.\\items.items.[INDEX].quantity","typeLabel":"integer"},"product_url":{"oneOf":[{"type":"string","description":"URL of the product. Either `product_id` or `product_url` must be provided.","uniqueKey":"cart.\\items.items.[INDEX].product_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL of the product. Either `product_id` or `product_url` must be provided.","uniqueKey":"cart.\\items.items.[INDEX].product_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"cart.\\items.items.[INDEX].product_url","typeLabel":"string | null"},"variable_price":{"type":"integer","description":"If this product has a variable price (e.g. a flex gift or a gift card), then this must be provided. A positive integer represented in cents.","uniqueKey":"cart.\\items.items.[INDEX].variable_price","typeLabel":"integer"},"variants":{"type":"array","items":{"type":"string","uniqueKey":"cart.\\items.items.[INDEX].variants.items.[INDEX]","typeLabel":"string"},"description":"An array of variant names (not IDs). When using the Direct Send send method with a product with variants, the variants must be provided. The length of the array must be equal to `variants_num_selectable` on the product, and the variants must come from the names of the `varaints` on the product. For example, for a t-shirt with `variants_num_selectable` = 1 and variants S, M, L, pass ['M']. Or, for a box of cookies with `variants_num_selectable` = 2 and variants Sugar, Caramel, Chocolate, pass ['Sugar', 'Chocolate'].","uniqueKey":"cart.\\items.items.[INDEX].variants","typeLabel":"string[]"}},"required":["product_id","quantity"],"uniqueKey":"cart.\\items.items.[INDEX]","typeLabel":"object"},"description":"An array of cart items.","uniqueKey":"cart.\\items","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"cart","typeLabel":"object"},"send_method":{"type":"string","enum":["email_and_link","link_multiple_custom_list","direct_send"],"description":"The method for sending a order batch. `email_and_link` sends a gift email to the recipient (specify `email` for each recipient). `link_multiple_custom_list` generates a gift link without an automatic email. `direct_send` ships the product directly to the recipient (specify `mailing_address` for each recipient). For more information, see [Send Methods](/introduction/send-methods).","isRequired":true,"uniqueKey":"send_method","typeLabel":"enum\u003cstring>"}},"required":["recipients","cart","send_method"],"uniqueKey":"","typeLabel":"object"},"examples":{"Order batch price calculated":{"title":"Order batch price calculated","value":{"send_method":"direct_send","recipients":[{"first_name":"Alena","last_name":"Kenter","email":"alena@example.com","mailing_address":{"first_name":"Alena","last_name":"Kenter","address_1":"140 E 55th St","address_2":"","city":"New York","state":"NY","postal_code":"10022","country":"US"}}],"cart":{"items":[{"product_id":"65c4e577-4226-4a2f-8298-aaffd3e34081","quantity":1}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"8f180710-31de-4ffc-91b5-47360faa6943":{"description":"Order batch price calculated","content":{"application/json":{"examples":{"Order batch price calculated":{"title":"Order batch price calculated","value":{"cart_price":{"price_product":1000,"price_shipping":1000,"price_processing_fee":100,"price_pre_tax":2100,"price_est_tax_low":0,"price_est_tax_high":210,"price_est_total_low":2100,"price_est_total_high":2310},"total_price":{"recipients":2,"est_group_total_low":4200,"est_group_total_high":4620}}},"Order batch price calculated for direct send":{"title":"Order batch price calculated for direct send","value":{"cart_price":{"price_product":1000,"price_shipping":1000,"price_processing_fee":100,"price_pre_tax":2100,"price_est_tax_low":0,"price_est_tax_high":210,"price_est_total_low":2100,"price_est_total_high":2310},"total_price":{"recipients":1,"est_tax_calculated":187,"est_total_calculated":2287}}}},"schema":{"type":"object","description":"The price for an order batch (all in cents).","properties":{"cart_price_estimate":{"type":"object","description":"Prices for a single recipient's cart in cents. This represents the price for each recipient in the order batch.","properties":{"price_product":{"type":"integer","description":"Total cost of products","isRequired":true,"uniqueKey":"cart_price_estimate.price_product","typeLabel":"integer"},"price_shipping":{"type":"integer","description":"Total shipping cost","isRequired":true,"uniqueKey":"cart_price_estimate.price_shipping","typeLabel":"integer"},"price_processing_fee":{"type":"integer","description":"Processing fee","isRequired":true,"uniqueKey":"cart_price_estimate.price_processing_fee","typeLabel":"integer"},"price_pre_tax":{"type":"integer","description":"Subtotal before tax","isRequired":true,"uniqueKey":"cart_price_estimate.price_pre_tax","typeLabel":"integer"},"price_est_tax_low":{"type":"integer","description":"Estimated tax (low-end, typically 0%)","isRequired":true,"uniqueKey":"cart_price_estimate.price_est_tax_low","typeLabel":"integer"},"price_est_tax_high":{"type":"integer","description":"Estimated tax (high-end, typically 10%)","isRequired":true,"uniqueKey":"cart_price_estimate.price_est_tax_high","typeLabel":"integer"},"price_est_total_low":{"type":"integer","description":"Estimated total (low-end tax, typically 0%)","isRequired":true,"uniqueKey":"cart_price_estimate.price_est_total_low","typeLabel":"integer"},"price_est_total_high":{"type":"integer","description":"Estimated total (high-end tax, typically 10%)","isRequired":true,"uniqueKey":"cart_price_estimate.price_est_total_high","typeLabel":"integer"}},"required":["price_product","price_shipping","price_processing_fee","price_pre_tax","price_est_tax_low","price_est_tax_high","price_est_total_low","price_est_total_high"],"uniqueKey":"cart_price_estimate","typeLabel":"object"},"total_price_estimate":{"type":"object","description":"Total price estimates for the entire order batch in cents. This includes all recipients.","properties":{"recipients":{"type":"integer","description":"Number of recipients in the batch","isRequired":true,"uniqueKey":"total_price_estimate.recipients","typeLabel":"integer"},"est_tax_calculated":{"oneOf":[{"type":"integer","description":"Direct send: calculated tax estimate when addresses are provided","uniqueKey":"total_price_estimate.est_tax_calculated.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Direct send: calculated tax estimate when addresses are provided","uniqueKey":"total_price_estimate.est_tax_calculated.oneOf.1","typeLabel":"null"}],"uniqueKey":"total_price_estimate.est_tax_calculated","typeLabel":"integer | null"},"est_total_calculated":{"oneOf":[{"type":"integer","description":"Calculated total estimate when addresses are provided","uniqueKey":"total_price_estimate.est_total_calculated.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Calculated total estimate when addresses are provided","uniqueKey":"total_price_estimate.est_total_calculated.oneOf.1","typeLabel":"null"}],"uniqueKey":"total_price_estimate.est_total_calculated","typeLabel":"integer | null"},"est_group_total_low":{"oneOf":[{"type":"integer","description":"Estimated minimum group total","uniqueKey":"total_price_estimate.est_group_total_low.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Estimated minimum group total","uniqueKey":"total_price_estimate.est_group_total_low.oneOf.1","typeLabel":"null"}],"uniqueKey":"total_price_estimate.est_group_total_low","typeLabel":"integer | null"},"est_group_total_high":{"oneOf":[{"type":"integer","description":"Estimated maximum group total","uniqueKey":"total_price_estimate.est_group_total_high.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Estimated maximum group total","uniqueKey":"total_price_estimate.est_group_total_high.oneOf.1","typeLabel":"null"}],"uniqueKey":"total_price_estimate.est_group_total_high","typeLabel":"integer | null"}},"required":["recipients"],"uniqueKey":"total_price_estimate","typeLabel":"object"}},"required":["cart_price","total_price"],"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"a994af85-460a-47d5-b798-c45811baecc1":{"description":"Invalid parameters","content":{"application/json":{"examples":{"Order batch price calculation error":{"title":"Order batch price calculation error","value":{"error":"Product not found: invalid"}}},"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"43b535e3-0250-4f7f-a282-3f9000cb898a":{"bearer":{"type":"http","scheme":"bearer","description":"Your Goody API key.","scopes":[],"schemeName":"bearer"}}},"servers":{"4a853b92-1c76-4ffd-85bf-5a5539f2953d":{"url":"https://api.ongoody.com","description":"Production"},"dd210492-7675-40b8-833a-2901e08fdf59":{"url":"https://api.sandbox.ongoody.com","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your Goody API key.","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your Goody API key.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"goody-api-openapi.json"},"subdomain":"goody","siteName":"Goody Developers","title":"Calculate the price for an order batch - Goody Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T14:28:25.836Z","originalFileLocation":"api-reference/order-batches/calculate-the-price-for-an-order-batch.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=\"keywords\" content=\"Goody API, Goody MCP server, gifting API, gift API, MCP server, send gifts with AI, Claude gifting connector, business gifting, autogift\">\u003cmeta data-mint-head name=\"application-name\" content=\"Goody Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/goody/cgM3s1zMuye1hA-n/_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/goody/cgM3s1zMuye1hA-n/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/goody/cgM3s1zMuye1hA-n/_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/goody/cgM3s1zMuye1hA-n/_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/goody/cgM3s1zMuye1hA-n/_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/goody/cgM3s1zMuye1hA-n/_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/goody/cgM3s1zMuye1hA-n/_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/goody/cgM3s1zMuye1hA-n/_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/goody/cgM3s1zMuye1hA-n/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Calculate the price for an order batch - Goody Developers\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Goody Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://goody.mintlify.app/_mintlify/api/og/v2?division=Order+Batches\u0026amp;title=Calculate+the+price+for+an+order+batch\u0026amp;theme=9ccd498c0c106549735ac92d\u0026amp;signature=d06e27094e7ef90a0b01c8175103fb65545db591548d143586f175c930ca2aed\">\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=\"Calculate the price for an order batch - Goody Developers\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://goody.mintlify.app/_mintlify/api/og/v2?division=Order+Batches\u0026amp;title=Calculate+the+price+for+an+order+batch\u0026amp;theme=9ccd498c0c106549735ac92d\u0026amp;signature=d06e27094e7ef90a0b01c8175103fb65545db591548d143586f175c930ca2aed\">\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/goody/cgM3s1zMuye1hA-n/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Goody Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9159D6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/order-batches/calculate-the-price-for-an-order-batch.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.ongoody.com/#organization\",\"name\":\"Goody Developers\",\"url\":\"https://developer.ongoody.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/goody/UtvUnxw3LhFrdzGW/logo.svg?fit=max\u0026auto=format\u0026n=UtvUnxw3LhFrdzGW\u0026q=85\u0026s=271862d59190ae3cec0a504caf00f0dc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.ongoody.com#website\",\"name\":\"Goody Developers\",\"url\":\"https://developer.ongoody.com\",\"publisher\":{\"@id\":\"https://developer.ongoody.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch#webpage\",\"url\":\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch\",\"name\":\"Calculate the price for an order batch\",\"dateModified\":\"2026-10-08T14:28:25.836Z\",\"isPartOf\":{\"@id\":\"https://developer.ongoody.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Order Batches\",\"item\":\"https://developer.ongoody.com/api-reference/order-batches/create-an-order-batch\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Calculate the price for an order batch\",\"item\":\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch#apireference\",\"headline\":\"Calculate the price for an order batch\",\"name\":\"Calculate the price for an order batch\",\"url\":\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch\",\"mainEntityOfPage\":{\"@id\":\"https://developer.ongoody.com/api-reference/order-batches/calculate-the-price-for-an-order-batch#webpage\"},\"dateModified\":\"2026-10-08T14:28:25.836Z\",\"publisher\":{\"@id\":\"https://developer.ongoody.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.ongoody.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Goody Developers\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Goody Developers","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction/overview"}]},{"anchor":"API Reference","icon":"square-terminal","groups":[{"group":"Order Batches","pages":[{"openapi":"POST /v1/order_batches","title":"Create an order batch","href":"/api-reference/order-batches/create-an-order-batch"},{"openapi":"GET /v1/order_batches","title":"List all order batches","href":"/api-reference/order-batches/list-all-order-batches"},{"openapi":"GET /v1/order_batches/{id}","title":"Retrieve an order batch","href":"/api-reference/order-batches/retrieve-an-order-batch"},{"openapi":"GET /v1/order_batches/{id}/orders","title":"Retrieve orders for an order batch","href":"/api-reference/order-batches/retrieve-orders-for-an-order-batch"},{"openapi":"GET /v1/order_batches/{id}/recipients","title":"Retrieve recipients for an order batch","description":null,"href":"/api-reference/order-batches/retrieve-recipients-for-an-order-batch"},{"openapi":"POST /v1/order_batches/price","title":"Calculate the price for an order batch","href":"/api-reference/order-batches/calculate-the-price-for-an-order-batch"}]},{"group":"Orders","pages":[{"openapi":"GET /v1/orders","title":"List all orders","description":null,"href":"/api-reference/orders/list-all-orders"},{"openapi":"GET /v1/orders/{id}","title":"Retrieve an order","href":"/api-reference/orders/retrieve-an-order"},{"openapi":"POST /v1/orders/{id}/cancel","title":"Cancel an order","href":"/api-reference/orders/cancel-an-order"},{"openapi":"POST /v1/orders/{id}/update_expiration","title":"Update expiration for an order","href":"/api-reference/orders/update-expiration-for-an-order"}]},{"group":"Brands","pages":[{"openapi":"GET /v1/brands","title":"List all active brands","href":"/api-reference/brands/list-all-active-brands"}]},{"group":"Products","pages":[{"openapi":"GET /v1/products","title":"List all active products","href":"/api-reference/products/list-all-active-products"},{"openapi":"GET /v1/products/{id}","title":"Retrieve a product","href":"/api-reference/products/retrieve-a-product"}]},{"group":"Payment Methods","pages":[{"openapi":"GET /v1/payment_methods","title":"List all payment methods","href":"/api-reference/payment-methods/list-all-payment-methods"}]},{"group":"Commerce User Payment Methods","pages":[{"openapi":"POST /v1/commerce_user_payment_methods","title":"Create a commerce user payment method","href":"/api-reference/commerce-user-payment-methods/create-a-commerce-user-payment-method"}]},{"group":"Workspaces","pages":[{"openapi":"GET /v1/workspaces","title":"List all workspaces","href":"/api-reference/workspaces/list-all-workspaces"}]},{"group":"Cards","pages":[{"openapi":"GET /v1/cards","title":"List all active cards","href":"/api-reference/cards/list-all-active-cards"}]},{"group":"Collections","pages":[{"openapi":"GET /v1/collections","title":"List all collections","href":"/api-reference/collections/list-all-collections"},{"openapi":"GET /v1/collections/{id}","title":"Retrieve a collection","href":"/api-reference/collections/retrieve-a-collection"}]},{"group":"Order Activities","pages":[{"openapi":"GET /v1/order_activities","title":"List all order activities","href":"/api-reference/order-activities/list-all-order-activities"}]},{"group":"Me","pages":[{"openapi":"GET /v1/me","title":"Retrieve current user","href":"/api-reference/retrieve-current-user"}]},{"group":"Schemas","pages":[{"group":"Schemas","pages":[{"title":"Error","icon":"cube","href":"/api-reference/schemas/error"},{"title":"ListMeta","icon":"cube","href":"/api-reference/schemas/listmeta"},{"title":"OrderBatch","icon":"cube","href":"/api-reference/schemas/orderbatch"},{"title":"Order","icon":"cube","href":"/api-reference/schemas/order"},{"title":"OrderBatchRecipient","icon":"cube","href":"/api-reference/schemas/orderbatchrecipient"},{"title":"Cart","icon":"cube","href":"/api-reference/schemas/cart"},{"title":"CartItem","icon":"cube","href":"/api-reference/schemas/cartitem"},{"title":"OrderBatchSendStatus","icon":"cube","href":"/api-reference/schemas/orderbatchsendstatus"},{"title":"OrderStatus","icon":"cube","href":"/api-reference/schemas/orderstatus"},{"title":"Shipment","icon":"cube","href":"/api-reference/schemas/shipment"},{"title":"Product","icon":"cube","href":"/api-reference/schemas/product"},{"title":"Brand","icon":"cube","href":"/api-reference/schemas/brand"},{"title":"ProductImage","icon":"cube","href":"/api-reference/schemas/productimage"},{"title":"ProductVariant","icon":"cube","href":"/api-reference/schemas/productvariant"},{"title":"Image","icon":"cube","href":"/api-reference/schemas/image"},{"title":"MailingAddress","icon":"cube","href":"/api-reference/schemas/mailingaddress"},{"title":"Me","icon":"cube","href":"/api-reference/schemas/me"},{"title":"Sender","icon":"cube","href":"/api-reference/schemas/sender"},{"title":"OrderBatchInput","icon":"cube","href":"/api-reference/schemas/orderbatchinput"},{"title":"CartInput","icon":"cube","href":"/api-reference/schemas/cartinput"},{"title":"CartItemInput","icon":"cube","href":"/api-reference/schemas/cartiteminput"},{"title":"OrderBatchSendMethod","icon":"cube","href":"/api-reference/schemas/orderbatchsendmethod"},{"title":"RecipientInput","icon":"cube","href":"/api-reference/schemas/recipientinput"},{"title":"RecipientInput","icon":"cube","href":"/api-reference/schemas/recipientinput"}]}]}]},{"anchor":"MCP Reference","icon":"robot","pages":[{"title":"MCP Reference","href":"/mcp-reference/capabilities"}]}]},"title":"Calculate the price for an order batch - Goody Developers","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-n7I5XbKb.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}