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

post

Get all available 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

Responses

200

200 OK

application/json

400

400 Bad Request

application/json

401

401 Unauthorized

application/json

403

403 Forbidden

application/json

405

405 Method Not Allowed

application/json

406

406 Not Acceptable

application/json

408

408 Request Timeout

application/json

429

429 Too Many Requests

application/json

500

500 Internal Server Error

application/json

502

502 Bad Gateway Error

application/json

503

503 Service Unavailable Error

application/json

504

504 Gateway Timeout Error

application/json

post

HTTPcURLJavaScriptPython

POST /shipping-quotes HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1262

{
  "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": "[email protected]",
    "organization": "Digital River",
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "shipFrom": {
    "address": {
      "line1": "10380 Bren Rd W",
      "line2": "text",
      "city": "Minnetonka",
      "postalCode": "55129",
      "state": "MN",
      "country": "US"
    },
    "additionalAddressInfo": {
      "neighborhood": "Centro",
      "division": "営業部",
      "phoneticName": "ヤマダ タロ"
    }
  },
  "packages": [
    {
      "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,
            "weightUnit": "oz",
            "partNumber": "SWG1224J10L",
            "partnerAccountId": "00g6atnynbl2wFsFG357"
          },
          "logisticsOptions": {
            "deliveryOptions": [
              "[\"direct_delivery_only\",\"additional_handling\"]"
            ],
            "dangerousGoods": [
              "nimh_battery"
            ]
          },
          "amount": 9.99,
          "quantity": 1
        }
      ],
      "weight": 5,
      "weightUnit": "oz",
      "height": 5,
      "width": 5,
      "length": 5
    }
  ]
}

{
  "currency": "USD",
  "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"
      },
      "shippingTerms": "DDP",
      "totalAmount": 5.99,
      "shipFrom": {
        "address": {
          "line1": "10380 Bren Rd W",
          "line2": "text",
          "city": "Minnetonka",
          "postalCode": "55129",
          "state": "MN",
          "country": "US"
        },
        "additionalAddressInfo": {
          "neighborhood": "Centro",
          "division": "営業部",
          "phoneticName": "ヤマダ タロ"
        }
      },
      "fees": {
        "details": [
          {
            "name": "Fuel Surcharge",
            "amount": 3.99
          }
        ],
        "amount": 4.99
      }
    }
  ],
  "liveMode": false
}