---
title: "GET /shipping_quote/{shippingQuoteId}"
method: GET
path: "/shipping_quote/{shippingQuoteId}"
tags: ["shipping_quote"]
---

# GET /shipping_quote/{shippingQuoteId}

`GET /shipping_quote/{shippingQuoteId}`

This method retrieves the complete details of the shipping quote associated with the specified <b>shippingQuoteId</b> value.  <br><br>A "shipping quote" pertains to a single specific package and contains a set of shipping "rates" that quote the cost to ship the package by different shipping carriers and services. The quotes are based on the package's origin, destination, and size.  <br><br>Call <b>createShippingQuote</b> to create a <b>shippingQuoteId</b>.

## Path parameters

- `shippingQuoteId` string, required

## Response `200`

Success

- ShippingQuote — This complex type describes a "shipping quote," which contains the parameters for a package shipment. The shipping quote contains a list of "live quotes" or <i>rates</i> for the shipment. Rates are offerd by a carrier for a particular service, of set of services, for shipping the package. Included in the shipping quote are the package specifications, the shipment's origin and destination addresses, and the shipping parameters specified by the seller. <br><br>Use the <b>rateId</b> value to select the specific service you want when you create a shipment by calling <b>createFromShippingQuote</b>.
  - `creationDate` string — The date and time this quote was created, expressed as an ISO 8601 UTC string.
  - `expirationDate` string — The last date and time that this quote will be honored, expressed as an ISO 8601 UTC string. After this time the quote expires and the expressed rates can no longer be purchased.
  - `orders` Order[] — This list value is optionally assigned by the seller. When present, each element in the returned list contains seller-assigned information about an order (such as an order number). Because a package can contain all or part of one or more orders, this field provides a way for sellers to identify the packages that contain specific orders.
    - `channel` string — The e-commerce platform or environment where the order was created. Use the value <code>EBAY</code> to get the rates available for eBay orders.
    - `orderId` string — The unique ID of the order supplied by the channel of origin. For eBay orders, this would be the <b>orderId</b>.
  - `packageSpecification` PackageSpecification — This complex type specifies the dimensions and weight of a package.
    - `dimensions` Dimensions — This complex type defines the dimensions of a package to be shipped.
      - `height` string — The numeric value of the height of the package.
      - `length` string — The numeric value of the length of the package.
      - `unit` string — The unit of measure used to express the height, length, and width of the package. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/logistics/types/api:LengthUnitOfMeasureEnum'>eBay API documentation</a>
      - `width` string — The numeric value of the width of the package.
    - `weight` Weight — This complex type contains information about the weight of an object such as a shipping package.
      - `unit` string — The unit of measurement used to specify the weight of a shipping package. Both the <strong>unit</strong> and <strong>value</strong> fields are required if the <strong>weight</strong> container is used. If the English system of measurement is being used, the applicable values for weight units are <code>POUND</code> and <code>OUNCE</CODE>. If the metric system of measurement is being used, the applicable values for weight units are <code>KILOGRAM</code> and <code>GRAM</code>. The metric system is used by most countries outside of the US. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/logistics/types/api:WeightUnitOfMeasureEnum'>eBay API documentation</a>
      - `value` string — The numeric value of the weight of the package, as measured by the value of <b>unit</b>.
  - `rates` Rate[] — A list of <i>rates</i> where each rate, as identified by a <b>rateId</b>, contains information about a specific shipping service offered by a carrier. Rates include shipping carrier and service, the to and from locations, the pickup and delivery windows, the seller's shipping parameters, the service constraints, and the cost for the base service and a list of additional shipping options. <br><br>Each rate offered is supported by a label service where you can purchase the rate, and associated shipping label, via a call to <b>createFromShippingQuote</b>.
    - `additionalOptions` AdditionalOption[] — Contains service and pricing information for one or more shipping options that are offered by the carrier and can be purchased in addition to the base shipping service provided by this rate. Shipping options can include items such as <code>INSURANCE</code> and <code>SIGNATURE</code>.
      - `additionalCost` Amount — A complex type that describes the value of a monetary amount as represented by a global currency.
        - `currency` string — The base currency applied to the <b>value</b> field to establish a monetary amount. <br><br>The currency is represented as a 3-letter <a href="https://www.iso.org/iso-4217-currency-codes.html" title="https://www.iso.org" target="_blank">ISO 4217</a> currency code. For example, the code for the Canadian Dollar is <code>CAD</code>. <br><br><b>Default:</b> The default currency of the eBay marketplace that hosts the listing. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/logistics/types/bas:CurrencyCodeEnum'>eBay API documentation</a>
        - `value` string — The monetary amount in the specified <b>currency</b>.
      - `optionType` string — The name of a shipping option that can be purchased in addition to the base shipping cost of this rate. The value supplied in this field must match exactly the option name as supplied by the selected rate.
    - `baseShippingCost` Amount — A complex type that describes the value of a monetary amount as represented by a global currency.
      - `currency` string — The base currency applied to the <b>value</b> field to establish a monetary amount. <br><br>The currency is represented as a 3-letter <a href="https://www.iso.org/iso-4217-currency-codes.html" title="https://www.iso.org" target="_blank">ISO 4217</a> currency code. For example, the code for the Canadian Dollar is <code>CAD</code>. <br><br><b>Default:</b> The default currency of the eBay marketplace that hosts the listing. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/logistics/types/bas:CurrencyCodeEnum'>eBay API documentation</a>
      - `value` string — The monetary amount in the specified <b>currency</b>.
    - `destinationTimeZone` string — The name of the time zone region, as defined in the <a href="http://www.iana.org/time-zones" target="_blank">IANA Time Zone Database</a>, to which the package is being shipped. <br><br>Delivery dates are calculated relative to this time zone. <br><br><span class="tablenote"><strong>Note:</strong> This is different from a Coordinated Universal Time (UTC) offset. For example, the <i>America/Los_Angeles</i> time zone identifies a region with the UTC standard time offset of <code>-08:00</code>, but so do several other time zones, including <i>America/Tijuana</i>,<i>America/Dawson</i>, and <i>Pacific/Pitcairn</i>.</span>
    - `maxEstimatedDeliveryDate` string — The latest stated date and time the shipment will be delivered at this rate. <br><br>The time stamp is formatted as an <a href="https://www.iso.org/iso-8601-date-and-time-format.html" title="https://www.iso.org" target="_blank">ISO 8601</a> string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. <br><br><b>Format:</b> <code>[YYYY]-[MM]-[DD]T[HH]:[MM]:[SS].[SSS]Z</code> <br><b>Example:</b> <code>2018-08-20T07:09:00.000Z</code>
    - `minEstimatedDeliveryDate` string — The estimated earliest date and time the shipment will be delivered at this rate. The time stamp is formatted as an ISO 8601 UTC string.
    - `pickupNetworks` string[] — A list of pickup networks compatible with the shipping service.
    - `pickupSlots` PickupSlot[] — A list of available pickup slots for the package.
      - `pickupSlotEndTime` string — The date and time the pickup slot ends, formatted as an <a href="https://www.iso.org/iso-8601-date-and-time-format.html" title="https://www.iso.org" target="_blank">ISO 8601</a> string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. <br><br><b>Format:</b> <code>[YYYY]-[MM]-[DD]T[HH]:[MM]:[SS].[SSS]Z</code> <br><b>Example:</b> <code>2018-08-20T07:09:00.000Z</code>
      - `pickupSlotId` string — Seller-defined name for the pickup slot. <!-- Max characters? -->
      - `pickupSlotStartTime` string — The date and time the pickup slot begins, formatted as an <a href="https://www.iso.org/iso-8601-date-and-time-format.html" title="https://www.iso.org" target="_blank">ISO 8601</a> UTC string.
      - `pickupSlotTimeZone` string — The time zone of the pickup location, returned as <a href="https://www.iana.org/time-zones" target="_blank">Time Zone Database</a> ID (also know as an Olson time zone ID).
    - `pickupType` string — The type of pickup or drop-off service associated with the <b>pickupSlots</b> time frames. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/logistics/types/api:PickupTypeEnum'>eBay API documentation</a>
    - `rateId` string — The unique eBay-assigned ID for this shipping rate.
    - `rateRecommendation` string[] — A list of reasons this rate is recommended. Available values are: <ul> <li><code>BUYER_CHOSEN</code> &mdash; The rate meets or exceeds the requirements of the buyer's preferred shipping option.</li> <li><code>CHEAPEST_ON_TIME</code> &mdash; The rate is the cheapest rate available that will provide delivery within the seller's time frame commitment.</li> <li><code>EBAY_PLUS_OK</code> &mdash; The rate complies with the shipping requirements of the eBay Plus program.</li> <li><code>FASTEST_ON_TIME</code> &mdash; The rate has the fastest shipping time, and will provide delivery within the seller's time frame commitment.</li> <li><code>GUARANTEED_DELIVERY_OK</code> &mdash; The rate complies with the shipping requirements of the eBay Guaranteed Delivery program.</li></ul>
    - `shippingCarrierCode` string — The code name of the shipping carrier who will provide the service identified by <b>shippingServiceCode</b>.
    - `shippingCarrierName` string — The common name of the shipping carrier.
    - `shippingServiceCode` string — The code name of the shipping service to be provided by the carrier identified by <b>shippingCarrierCode</b>.
    - `shippingServiceName` string — The common name of the shipping service.
  - `shipFrom` Contact — This complex type contains contact information for an individual buyer or seller.
    - `companyName` string — The company name with which the contact is associated.
    - `contactAddress` ContactAddress — This complex type specifies the details of a geographical address.
      - `addressLine1` string — The first line of the street address.
      - `addressLine2` string — The second line of the street address. Use this field for additional address information, such as a suite or apartment number.
      - `city` string — The city in which the address is located.
      - `countryCode` string — The country of the address, represented as two-letter <a href="https://www.iso.org/iso-3166-country-codes.html" title="https://www.iso.org" target="_blank">ISO 3166</a> country code. For example, <code>US</code> represents the United States and <code>DE</code> represents Germany. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/logistics/types/bas:CountryCodeEnum'>eBay API documentation</a>
      - `county` string — The county (not country) in which the address is located. Counties typically contain multiple cities or towns.
      - `postalCode` string — The postal code of the address.
      - `stateOrProvince` string — The state or province in which the address is located. States and provinces often contain multiple counties.
    - `fullName` string — The contact's full name.
    - `primaryPhone` PhoneNumber — This complex type contains a string field representing a telephone number.
      - `phoneNumber` string — A telephone number.
  - `shipTo` Contact — This complex type contains contact information for an individual buyer or seller.
    - `companyName` string — The company name with which the contact is associated.
    - `contactAddress` ContactAddress — This complex type specifies the details of a geographical address.
      - `addressLine1` string — The first line of the street address.
      - `addressLine2` string — The second line of the street address. Use this field for additional address information, such as a suite or apartment number.
      - `city` string — The city in which the address is located.
      - `countryCode` string — The country of the address, represented as two-letter <a href="https://www.iso.org/iso-3166-country-codes.html" title="https://www.iso.org" target="_blank">ISO 3166</a> country code. For example, <code>US</code> represents the United States and <code>DE</code> represents Germany. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/logistics/types/bas:CountryCodeEnum'>eBay API documentation</a>
      - `county` string — The county (not country) in which the address is located. Counties typically contain multiple cities or towns.
      - `postalCode` string — The postal code of the address.
      - `stateOrProvince` string — The state or province in which the address is located. States and provinces often contain multiple counties.
    - `fullName` string — The contact's full name.
    - `primaryPhone` PhoneNumber — This complex type contains a string field representing a telephone number.
      - `phoneNumber` string — A telephone number.
  - `shippingQuoteId` string — The unique eBay-assigned ID for this shipping quote. The value of this field is associated with a specific package, based on its origin, destination, and size.
  - `warnings` Error[] — A list of any warnings triggered by the request.
    - `category` string — The category type for this error or warning. It takes a string that can have one of three values:<ul><li><code>Application</code>: Indicates an exception or error occurred in the application code or at runtime. Examples include catching an exception in a service's business logic, system failures, or request errors from a dependency.</li><li><code>Business</code>: Used when your service or a dependent service refused to continue processing on the resource because of a business rule violation such as "Seller does not ship item to Antarctica" or "Buyer ineligible to purchase an alcoholic item". Business errors are not syntactical input errors.</li><li><code>Request</code>: Used when there is anything wrong with the request, such as authentication, syntactical errors, rate limiting or missing headers, bad HTTP header values, and so on.</li></ul>
    - `domain` string — Name of the domain containing the service or application.
    - `errorId` integer — A positive integer that uniquely identifies the specific error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms.
    - `inputRefIds` string[] — Identifies specific request elements associated with the error, if any. inputRefId's response is format specific. For JSON, use <i>JSONPath</i> notation.
    - `longMessage` string — An expanded version of message that should be around 100-200 characters long, but is not required to be such.
    - `message` string — An end user and app-developer friendly device agnostic message. It explains what the error or warning is, and how to fix it (in a general sense). Its value is at most 50 characters long. If applicable, the value is localized in the end user's requested locale.
    - `outputRefIds` string[] — Identifies specific response elements associated with the error, if any. Path format is the same as <code>inputRefId</code>.
    - `parameters` ErrorParameter[] — This optional complex field type contains a list of one or more context-specific <code>ErrorParameter</code> objects, with each item in the list entry being a parameter (or input field name) that caused an error condition. Each <code>ErrorParameter</code> object consists of two fields, a <code>name</code> and a <code>value</code>.
      - `name` string — Name of the entity that threw the error.
      - `value` string — A description of the error.
    - `subdomain` string — Name of the domain's subsystem or subdivision. For example, checkout is a subdomain in the buying domain.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/ebay/apis/sell-logistics.md) · [All operations](https://skmtc.net/ebay/apis/sell-logistics/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ebay/sell-logistics/versions/58b322828ded/schema)
