Drop-in shipping quotes

The Drop-in Shipping Quotes resource provides a seamless integration for retrieving real-time shipping costs directly within your application. It enables developers to access up-to-date shipping information from multiple carriers, empowering businesses to offer accurate pricing to their customers at checkout. The resource is designed to be easy to use, requiring minimal setup while offering robust and customizable features to fit diverse shipping needs.

Returns shipping method quotes

post

Get all available shipping method quotes

Body

sessionIdstringrequired

The identifier of the checkout session associated with the shipping quotes request.

Example: 7765374748

sessionUpstreamIdstringoptional

The upstreamId of the checkout-session associated with the shipping quotes request.

Example: 8234373746

currencystringrequired

A three-letter ISO currency code.

Example: USD

shipToobjectrequired

itemsobject[]required

shippingMethodsobject[]optional

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/checkout/shipping-quotes' \
  --header 'Content-Type: application/json' \
  --data '{
    "sessionId": "7765374748",
    "sessionUpstreamId": "8234373746",
    "currency": "USD",
    "shipTo": {
      "address": {
        "line1": "10380 Bren Rd W",
        "line2": "text",
        "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": "ヤマダ タロ"
      }
    },
    "items": [
      {
        "id": "abc",
        "amount": 9.99,
        "quantity": 1,
        "sku": {
          "id": "sku_5823594809",
          "eccn": "EAR99",
          "taxCode": "4323.310_A",
          "name": "Athena Womens Running Shoes",
          "image": "https://imageurl.com",
          "url": "https://producturl.com",
          "physical": true,
          "metadata": {
            "coupon": "iOS"
          }
        },
        "logisticsOptions": {
          "deliveryOptions": [
            "[\"direct_delivery_only\",\"additional_handling\"]"
          ],
          "dangerousGoods": [
            "nimh_battery"
          ]
        }
      }
    ],
    "shippingMethods": [
      {
        "id": "65",
        "description": "Standard",
        "serviceLevel": "Standard",
        "shippingTerms": "DDP",
        "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"
        },
        "amount": 5.99,
        "shipFrom": {
          "address": {
            "line1": "10380 Bren Rd W",
            "line2": "text",
            "city": "Minnetonka",
            "postalCode": "55129",
            "state": "MN",
            "country": "US"
          },
          "additionalAddressInfo": {
            "neighborhood": "Centro",
            "division": "営業部",
            "phoneticName": "ヤマダ タロ"
          }
        }
      }
    ]
  }'

200

400

401

403

405

406

408

429

500

502

503

504

200

{
  "shipments": [
    {
      "itemIds": [
        "1234-4567-7890-12345"
      ],
      "shipFrom": {
        "address": {
          "line1": "10380 Bren Rd W",
          "line2": "text",
          "city": "Minnetonka",
          "postalCode": "55129",
          "state": "MN",
          "country": "US"
        },
        "additionalAddressInfo": {
          "neighborhood": "Centro",
          "division": "営業部",
          "phoneticName": "ヤマダ タロ"
        }
      }
    }
  ],
  "shippingMethods": [
    {
      "id": "65",
      "description": "Standard",
      "serviceLevel": "Standard",
      "shippingTerms": "DDP",
      "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"
      },
      "amount": 5.99,
      "shipFrom": {
        "address": {
          "line1": "10380 Bren Rd W",
          "line2": "text",
          "city": "Minnetonka",
          "postalCode": "55129",
          "state": "MN",
          "country": "US"
        },
        "additionalAddressInfo": {
          "neighborhood": "Centro",
          "division": "営業部",
          "phoneticName": "ヤマダ タロ"
        }
      }
    }
  ],
  "liveMode": false
}

200 OK