--- title: "Returns shipping method quotes" method: POST path: "/checkout/shipping-quotes" tags: ["Drop-in Shipping Quotes"] --- # Returns shipping method quotes `POST /checkout/shipping-quotes` Get all available shipping method quotes ## Request body - ShippingMethodQuoteRequest - `sessionId` string, required — The identifier of the checkout session associated with the shipping quotes request. - `sessionUpstreamId` string — The upstreamId of the checkout-session associated with the shipping quotes request. - `currency` string, required — A three-letter ISO currency code. - `shipTo` Shipping, required - `address` Address — Represents basic address information. - `line1` string, nullable — The first line of the address. - `line2` string — The second line of the address. - `city` string, nullable — The city of the address. - `postalCode` string, nullable — The postal code of the address. - `state` string, nullable — The state, county, province, or region. - `country` string, required — A [two-letter Alpha-2 country code](https://www.iban.com/country-codes) as described in the [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) international standard. - `name` string, nullable — The recipient’s name. - `phone` string, nullable — The recipient’s phone number. - `email` string, email, nullable — The recipient’s email address. - `organization` string, nullable — The recipient’s organization. - `additionalAddressInfo` AdditionalAddressInfo — Captures any information that's not included in the basic address. - `neighborhood` string, nullable — The neighborhood of the address. - `division` string, nullable — A division within an organization. - `phoneticName` string, nullable — The phonetic spelling of a name. - `items` ShippingMethodQuoteItemRequest[], required - `id` string, required — The item identifier. - `amount` number, double, required — The price of the product. - `quantity` integer, required - `sku` DropInSku - `id` string — The SKU's unique identifier. - `eccn` string — The export control classification number. - `taxCode` string — The designated tax code. - `name` string — The product’s name. - `image` string — An image of the product. - `url` string — A product url. - `physical` boolean — Identifies whether or not a product is physical, so that the appropriate data requirements are enforced. - `metadata` Metadata — Key-value pairs used to store additional data. Value can be string, boolean or integer types. - `logisticsOptions` ItemLogisticsOptions — In the [Global Logistics](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics) solution, logisticsOptions allows you to define a list of services that you want the carrier to provide. If you select any of these options, the appropriate fees are added to the shipping quotes that customers select from during the checkout process and the necessary information is added to shipping labels during the fulfillment process.

There are two ways to provide these logisticsOptions. You can either (1) store them in the product's [SKU Group](https://docs.digitalriver.com/digital-river-api/product-management/setting-up-sku-groups) or (2) pass them in checkout and shipping quotes requests at run-time. If you take the second approach, and logisticsOptions exist in a request, then you’re required to define a list of deliveryOptions and/or dangerousGoods.

In either case, we pass your selected options to the [Global Logistics Provider](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics#global-logistics-providers) so that the carrier is made aware that these services need to be provided. - `deliveryOptions` string[] —
A set of value-added services offered by the [Global Logistics Provider](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics#global-logistics-providers). They provide additional assurances that packages are delivered successfully and that shipping rates are appropriately calculated.

signature_required - Requires that an individual signs for the package at the time of delivery.

adult_signature_required - Requires that an individual who is at least 21 years of age signs for the package at the time of delivery. It’s useful for high-value, dangerous, and age-sensitive items, or as a prevention against theft. After an adult signs for the delivery, the purchaser receives a notification that contains an image of that signature, along with other delivery details.

direct_delivery_only - Ensures that the package is only delivered to the address provided by the customer at the time of purchase. In other words, the package can't be redirected to another address. No signature is required with this option, so if that's something you'd like to collect, you'll need to add signature_required or adult_signature_required to deliveryOptions.

additional_handling - Indicates that a product requires special handling because it's heavy and/or shipped in a large package. If you select this option, then a surcharge is automatically added to each shipping quote that customers select from, regardless of the package’s weight or dimensions.

However, if additional_handling doesn’t exist, but the weight and dimensional values in the request exceed thresholds established by the carrier, that same surcharge is still applied.

Using additional_handling can help minimize your financial risk. This is because if a package’s dimensions and weight are omitted or incorrectly defined in a request and the actual scale weight of the package at the time of shipment exceeds the carrier defined thresholds, thereby incurring a surcharge, then the customer will have underpaid for shipping at checkout, leaving you to make up the difference.

- `dangerousGoods` string[] — Indicates that the product poses unreasonable health, safety, or property risks when shipped and therefore requires special packaging, handling, and modes of transportation. For example, some products, such as lithium batteries and (in)flammable perfumes, are susceptible to static electricity as well as temperature and pressure variations. These forces can cause them to leak, emit toxic fumes, ignite, or even explode.

If a product is considered hazardous, and you opt not to store this information in its [SKU Group](https://docs.digitalriver.com/digital-river-api/product-management/setting-up-sku-groups), then dangerousGoods must list the category it falls into. - `shippingMethods` ShippingMethodQuote[] - `id` string — The identifier of the shipping method - `description` string — Shipping method description - `serviceLevel` string - `shippingTerms` 'DDP' | 'DAP' — The terms of shipping. - `deliveryInformation` DeliveryInformation — Represents a shipping option's delivery informationi in the [Global Logistics](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics) solution.

Which nested objects exist within deliveryInformation depends on the [Global logistics provider](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics#global-logistics-providers) that is facilitating the transaction. For example, not all [GLPs](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics#global-logistics-providers) provide an estimatedArrival.

The estimatedArrival is conditional on pickupDate and supportCutoffTime. If the final mile carrier collects the shipment by supportCutoffTime on pickupDate, then it should be at its destination by estimatedArrival.date. - `businessDaysInTransit` string — The estimated number of business days that the shipment will take to arrive at its final destination. Its value might be a single day or a range of days. - `estimatedArrival` EstimatedArrival — The estimated date and dayOfWeek that the shipment will arrive. - `date` string, date-time — The estimated date and time the shipment will arrive at its final destination. - `dayOfWeek` string — The estimated day of the week that the shipment will arrive at its final destination. - `pickupDate` string, date-time — The estimated time and date that the carrier will take possession of the packages in the shipment. - `weekendService` WeekendService - `saturdayDelivery` boolean — If true, then delivery will be scheduled for Saturday and, in the [Global Logistics](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics) solution, an additional fee is charged for the service. If false, then delivery on that day is not available or it is available but additional fees are not collected. In this case, check dayOfWeek to determine if it's a Saturday delivery. - `sundayDelivery` boolean — If true, then delivery will be scheduled for Sunday and, in the [Global Logistics](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics) solution, an additional fee is charged for the service. If false, then delivery on that day is not available or it is available but additional fees are not collected. In this case, check dayOfWeek to determine if it's a Sunday delivery. - `supportCutoffTime` string — In the [Global Logistics](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics) solution, this represents the time of day by which the carrier must take possession of the shipment on pickUpDate for it to get to its final destination by estimatedArrival.date. - `amount` number, double — The shipping amount. - `shipFrom` GLShipFrom — The address of the warehouse from which a physical product is shipped. - `address` GLAddress — Represents basic address information. - `line1` string, nullable — The first line of the address. - `line2` string — The second line of the address. - `city` string, nullable — The city of the address. - `postalCode` string, nullable — The postal code of the address. - `state` string, nullable — The state, county, province, or region. - `country` string — A [two-letter Alpha-2 country code](https://www.iban.com/country-codes) as described in the [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) international standard. - `additionalAddressInfo` AdditionalAddressInfo — Captures any information that's not included in the basic address. - `neighborhood` string, nullable — The neighborhood of the address. - `division` string, nullable — A division within an organization. - `phoneticName` string, nullable — The phonetic spelling of a name. ## Response `200` 200 OK - ShippingMethodQuoteResponse - `shipments` ShippingMethodQuoteItemResponse[] - `itemIds` string[] - `shipFrom` ShipFrom — The address from which a physical product is shipped. - `address` Address — Represents basic address information. - `line1` string, nullable — The first line of the address. - `line2` string — The second line of the address. - `city` string, nullable — The city of the address. - `postalCode` string, nullable — The postal code of the address. - `state` string, nullable — The state, county, province, or region. - `country` string, required — A [two-letter Alpha-2 country code](https://www.iban.com/country-codes) as described in the [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) international standard. - `additionalAddressInfo` AdditionalAddressInfo — Captures any information that's not included in the basic address. - `neighborhood` string, nullable — The neighborhood of the address. - `division` string, nullable — A division within an organization. - `phoneticName` string, nullable — The phonetic spelling of a name. - `shippingMethods` ShippingMethodQuote[] - `id` string — The identifier of the shipping method - `description` string — Shipping method description - `serviceLevel` string - `shippingTerms` 'DDP' | 'DAP' — The terms of shipping. - `deliveryInformation` DeliveryInformation — Represents a shipping option's delivery informationi in the [Global Logistics](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics) solution.

Which nested objects exist within deliveryInformation depends on the [Global logistics provider](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics#global-logistics-providers) that is facilitating the transaction. For example, not all [GLPs](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics#global-logistics-providers) provide an estimatedArrival.

The estimatedArrival is conditional on pickupDate and supportCutoffTime. If the final mile carrier collects the shipment by supportCutoffTime on pickupDate, then it should be at its destination by estimatedArrival.date. - `businessDaysInTransit` string — The estimated number of business days that the shipment will take to arrive at its final destination. Its value might be a single day or a range of days. - `estimatedArrival` EstimatedArrival — The estimated date and dayOfWeek that the shipment will arrive. - `date` string, date-time — The estimated date and time the shipment will arrive at its final destination. - `dayOfWeek` string — The estimated day of the week that the shipment will arrive at its final destination. - `pickupDate` string, date-time — The estimated time and date that the carrier will take possession of the packages in the shipment. - `weekendService` WeekendService - `saturdayDelivery` boolean — If true, then delivery will be scheduled for Saturday and, in the [Global Logistics](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics) solution, an additional fee is charged for the service. If false, then delivery on that day is not available or it is available but additional fees are not collected. In this case, check dayOfWeek to determine if it's a Saturday delivery. - `sundayDelivery` boolean — If true, then delivery will be scheduled for Sunday and, in the [Global Logistics](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics) solution, an additional fee is charged for the service. If false, then delivery on that day is not available or it is available but additional fees are not collected. In this case, check dayOfWeek to determine if it's a Sunday delivery. - `supportCutoffTime` string — In the [Global Logistics](https://docs.digitalriver.com/digital-river-api/using-our-services/global-logistics) solution, this represents the time of day by which the carrier must take possession of the shipment on pickUpDate for it to get to its final destination by estimatedArrival.date. - `amount` number, double — The shipping amount. - `shipFrom` GLShipFrom — The address of the warehouse from which a physical product is shipped. - `address` GLAddress — Represents basic address information. - `line1` string, nullable — The first line of the address. - `line2` string — The second line of the address. - `city` string, nullable — The city of the address. - `postalCode` string, nullable — The postal code of the address. - `state` string, nullable — The state, county, province, or region. - `country` string — A [two-letter Alpha-2 country code](https://www.iban.com/country-codes) as described in the [ISO 3166](https://www.iso.org/iso-3166-country-codes.html) international standard. - `additionalAddressInfo` AdditionalAddressInfo — Captures any information that's not included in the basic address. - `neighborhood` string, nullable — The neighborhood of the address. - `division` string, nullable — A division within an organization. - `phoneticName` string, nullable — The phonetic spelling of a name. - `liveMode` boolean — Has the value true if the object exists in live mode or the value false if the object exists in test mode. ## Other responses - `400` — 400 Bad Request - `401` — 401 Unauthorized - `403` — 403 Forbidden - `405` — 405 Method Not Allowed - `406` — 406 Not Acceptable - `408` — 408 Request Timeout - `429` — 429 Too Many Requests - `500` — 500 Internal Server Error - `502` — 502 Bad Gateway Error - `503` — 503 Service Unavailable Error - `504` — 504 Gateway Timeout Error --- [API](https://skmtc.net/digitalriver/apis/digital-river-api-reference.md) · [All operations](https://skmtc.net/digitalriver/apis/digital-river-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalriver/digital-river-api-reference/revisions/f21981db32be/schema)