API Documentation
- Admin Api Keys
- Admin Campaigns
- Admin Claims
- Admin Collections
- Admin Currencies
- Admin Customer Groups
- Admin Customers
- Admin Draft Orders
- Admin Exchanges
- Admin Fulfillment Providers
- Admin Fulfillment Sets
- Admin Fulfillments
- Admin Gift Cards
- Admin Inventory Items
- Admin Invites
- Admin Notifications
- Admin Order Edits
- Admin Orders
- Admin Payment Collections
- Admin Payments
- Admin Plugins
- Admin Price Lists
- Admin Price Preferences
- Admin Product Categories
- Admin Product Tags
- Admin Product Types
- Admin Product Variants
- Admin Products
- Admin Promotions
- Admin Refund Reasons
- Admin Regions
- Admin Reservations
- Admin Return Reasons
- Admin Returns
- Admin Sales Channels
- Admin Shipping Options
- Admin Shipping Profiles
- Admin Stock Locations
- Admin Store Credit Accounts
- Admin Stores
- Admin Tax Providers
- Admin Tax Rates
- Admin Tax Regions
- Admin Transaction Groups
- Admin Uploads
- Admin Users
- Admin Workflows Executions
- Store Auth
- Admin Auth
- Store Carts
- Store Collections
- Store Currencies
- Store Customers
- Store Gift Cards
- Store Orders
- Store Payment Collections
- Store Payment Providers
- Store Product Categories
- Store Product Tags
- Store Product Types
- Store Products
- Store Regions
- Store Return Reasons
- Store
- Store Shipping Options
- Store Store Credit Accounts
- Admin Algolia
- Admin Attributes
- Admin Commission
- Admin Configuration
- Admin Order Sets
- Admin Requests
- Admin Return Request
- Admin Reviews
- Admin Sellers
- Auth
- Store Return Request
- Store Reviews
- Store Sellers
- Store Wishlist
- Vendor Attributes
- Vendor Campaigns
- Vendor Commission
- Vendor Configuration
- Vendor Customer Groups
- Vendor Customers
- Vendor Fulfillment Providers
- Vendor Fulfillment Sets
- Vendor Inventory Items
- Vendor Invites
- Vendor Current Member
- Vendor Members
- Vendor Notifications
- Vendor Orders
- Vendor Payout Account
- Vendor Payouts
- Vendor Price Lists
- Vendor Price Preferences
- Vendor Product Categories
- Vendor Product Collections
- Vendor Product Tags
- Vendor Product Types
- Vendor Products
- Vendor Promotions
- Vendor Regions
- Vendor Requests
- Vendor Reservations
- Vendor Return Requests
- Vendor Returns
- Vendor Sales Channels
- Vendor Sellers
- Vendor Onboarding
- Vendor Reviews
- Vendor Shipping Options
- Vendor Shipping Profiles
- Vendor Statistics
- Vendor Stock Locations
- Vendor Stores
Store Shipping Options
Calculate Shipping Option Price
Calculate the price of a shipping option in a cart.
POST
/
store
/
shipping-options
/
{id}
/
calculate
Copy
import Medusa from "@medusajs/js-sdk"
let MEDUSA_BACKEND_URL = "http://localhost:9000"
if (process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL) {
MEDUSA_BACKEND_URL = process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL
}
export const sdk = new Medusa({
baseUrl: MEDUSA_BACKEND_URL,
debug: process.env.NODE_ENV === "development",
publishableKey: process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,
})
sdk.store.fulfillment.calculate("so_123", {
cart_id: "cart_123"
})
.then(({ shipping_option }) => {
console.log(shipping_option)
})
Copy
{
"shipping_option": {
"id": "<string>",
"name": "<string>",
"price_type": "flat",
"service_zone_id": "<string>",
"provider_id": "<string>",
"provider": {
"id": "<string>",
"is_enabled": true
},
"type": {
"id": "<string>",
"label": "<string>",
"description": "<string>",
"code": "<string>"
},
"shipping_profile_id": "<string>",
"amount": 123,
"data": {},
"prices": [
{
"id": "<string>",
"currency_code": "usd",
"amount": 123,
"min_quantity": 123,
"max_quantity": 123,
"price_rules": [
{
"id": "<string>",
"attribute": "<string>",
"operator": "gt",
"value": "<string>"
}
]
}
],
"calculated_price": {
"id": "<string>",
"is_calculated_price_price_list": true,
"is_calculated_price_tax_inclusive": true,
"calculated_amount": 123,
"calculated_amount_with_tax": 123,
"calculated_amount_without_tax": 123,
"is_original_price_price_list": true,
"is_original_price_tax_inclusive": true,
"original_amount": 123,
"currency_code": "<string>",
"calculated_price": {
"id": "<string>",
"price_list_id": "<string>",
"price_list_type": "<string>",
"min_quantity": 123,
"max_quantity": 123
},
"original_price": {
"id": "<string>",
"price_list_id": "<string>",
"price_list_type": "<string>",
"min_quantity": 123,
"max_quantity": 123
},
"original_amount_with_tax": 123,
"original_amount_without_tax": 123
},
"insufficient_inventory": true
}
}
Headers
Publishable API Key created in the Medusa Admin.
Path Parameters
The shipping option's ID.
Query Parameters
Comma-separated fields that should be included in the returned data.
if a field is prefixed with +
it will be added to the default fields, using -
will remove it from the default fields.
without prefix it will replace the entire default fields.
Body
application/json
The calculation's details.
Response
200
application/json
OK
The shipping option's details.
Copy
import Medusa from "@medusajs/js-sdk"
let MEDUSA_BACKEND_URL = "http://localhost:9000"
if (process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL) {
MEDUSA_BACKEND_URL = process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL
}
export const sdk = new Medusa({
baseUrl: MEDUSA_BACKEND_URL,
debug: process.env.NODE_ENV === "development",
publishableKey: process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,
})
sdk.store.fulfillment.calculate("so_123", {
cart_id: "cart_123"
})
.then(({ shipping_option }) => {
console.log(shipping_option)
})
Copy
{
"shipping_option": {
"id": "<string>",
"name": "<string>",
"price_type": "flat",
"service_zone_id": "<string>",
"provider_id": "<string>",
"provider": {
"id": "<string>",
"is_enabled": true
},
"type": {
"id": "<string>",
"label": "<string>",
"description": "<string>",
"code": "<string>"
},
"shipping_profile_id": "<string>",
"amount": 123,
"data": {},
"prices": [
{
"id": "<string>",
"currency_code": "usd",
"amount": 123,
"min_quantity": 123,
"max_quantity": 123,
"price_rules": [
{
"id": "<string>",
"attribute": "<string>",
"operator": "gt",
"value": "<string>"
}
]
}
],
"calculated_price": {
"id": "<string>",
"is_calculated_price_price_list": true,
"is_calculated_price_tax_inclusive": true,
"calculated_amount": 123,
"calculated_amount_with_tax": 123,
"calculated_amount_without_tax": 123,
"is_original_price_price_list": true,
"is_original_price_tax_inclusive": true,
"original_amount": 123,
"currency_code": "<string>",
"calculated_price": {
"id": "<string>",
"price_list_id": "<string>",
"price_list_type": "<string>",
"min_quantity": 123,
"max_quantity": 123
},
"original_price": {
"id": "<string>",
"price_list_id": "<string>",
"price_list_type": "<string>",
"min_quantity": 123,
"max_quantity": 123
},
"original_amount_with_tax": 123,
"original_amount_without_tax": 123
},
"insufficient_inventory": true
}
}
Assistant
Responses are generated using AI and may contain mistakes.