Shipping quotes

The Shipping Quotes resource is a critical component for retrieving detailed shipping options, costs, and estimated delivery times. This API endpoint allows users to compare various carriers, select the most cost-effective shipping method, and streamline logistics by efficiently managing shipping decisions based on real-time data. See Using shipping quotes for more information.

Returns shipping quotes

Get all available shipping quotes

post

/shipping-quotes

Authorizations

Body

currencystringrequired

A three-letter ISO currency code that determines what currency the cost of each shipping quote is converted into.

Example: USD

shipToShippingrequired

shipFromGLShipFrom

The address of the warehouse from which a physical product is shipped.

packagesShippingQuotePackages[]required

Responses

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.digitalriver.com/shipping-quotes' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"currency":"USD","shipTo":{"address":{"line1":"10380 Bren Rd W","city":"Minnetonka","postalCode":"55129","state":"MN","country":"US"},"name":"John Smith","phone":"952-111-1111","email":"[e-mail]","organization":"Digital River","additionalAddressInfo":{"neighborhood":"Centro","division":"営業部","phoneticName":"ヤマダ タロ"}},"shipFrom":{"address":{"line1":"10380 Bren Rd W","city":"Minnetonka","postalCode":"55129","state":"MN","country":"US"},"additionalAddressInfo":{"neighborhood":"Centro","division":"営業部","phoneticName":"ヤマダ タロ"}},"packages":[{"weight":5,"height":5,"width":5,"length":5,"weightUnit":"oz","items":[{"productDetails":{"id":"100067660336","skuGroupId":"wireless-keyboards","name":"Keyboard","description":"Top rated keyboard","itemBreadcrumb":"Sports & Outdoors > Exercise & Fitness > Wearable Technology > Fitness Trackers","url":"https://producturl.com","countryOfOrigin":"US","image":"https://imageurl.com","weight":20.5,"partNumber":"SWG1224J10L","partnerAccountId":"00g6atnynbl2wFsFG357","weightUnit":"oz"},"logisticsOptions":{"deliveryOptions":["[\"direct_delivery_only\",\"additional_handling\"]"],"dangerousGoods":["nimh_battery"]},"amount":9.99,"quantity":1}]}]}'

200

400

401

403

405

406

408

429

500

502

503

504

200

{
  "currency": "USD",
  "liveMode": false,
  "quotes": [
    {
      "id": "123-456-789",
      "description": "Standard",
      "serviceLevel": "Standard",
      "deliveryInformation": {
        "businessDaysInTransit": "3 - 5 Business Days",
        "estimatedArrival": {
          "date": "2018-04-25T20:36:00Z",
          "dayOfWeek": "Tuesday"
        },
        "pickupDate": "2018-04-25T20:36:00Z",
        "weekendService": {
          "saturdayDelivery": true,
          "sundayDelivery": false
        },
        "supportCutoffTime": "180000"
      },
      "totalAmount": 5.99,
      "shipFrom": {
        "address": {
          "line1": "10380 Bren Rd W",
          "city": "Minnetonka",
          "postalCode": "55129",
          "state": "MN",
          "country": "US"
        },
        "additionalAddressInfo": {
          "neighborhood": "Centro",
          "division": "営業部",
          "phoneticName": "ヤマダ タロ"
        }
      },
      "fees": {
        "amount": 4.99,
        "details": [
          {
            "name": "Fuel Surcharge",
            "amount": 3.99
          }
        ]
      },
      "shippingTerms": "DDP"
    }
  ]
}

200 OK