Estimate Shipment Rate

This API describes how to get a shipment rate estimation.

Method: POST

Request Body

json

{
  "shipping_methods": [
    { "shipping_method": "STAND" },
    { "shipping_method": "PLUS" },
    { "shipping_method": "UPS01" }
  ],
  "currency": "USD",
  "warehouse_code": "LAX",
  "from_address": {
    "address_1": "123 First St.",
    "address_2": "",
    "city": "Anytown",
    "state": "CA",
    "zip": "90210",
    "country": "US"
  },
  "to_address": {
    "address_1": "1 MAIN ST",
    "address_2": "",
    "city": "Anytown",
    "state": "CA",
    "zip": "90210",
    "country": "US"
  },
  "package": {
    "weight": 20.35,
    "width": 12.55,
    "length": 15.2,
    "height": 4.7
  }
}

Request Body Explanation

Attribute Name	Type	Description
shipping_methods	List	Method of shipping
shipping_method	String	Several shipping methods need to query
currency	String	Currency code, only support USD for now
warehouse_code	String	code of the warehouse shipping from
from_address	Object	sender's address
to_address	Object	consignee's address
address_1	String	address line 1
address_2	String	address line 2
city	String	city name
state	String	state or province
zip	String	zip code
country	String	country name
package	Object	package information
weight	Float	package weight, unit LB
width	Float	package width, unit inch
length	Float	package length, unit inch
height	Float	package height, unit inch

Response Body

json

{
  "code": 200,
  "data": [
    {
      "currency": "USD",
      "shipping_method": "STAND",
      "estimated_cost": 17.6
    },
    {
      "currency": "USD",
      "shipping_method": "PLUS",
      "estimated_cost": 17.6
    },
    {
      "currency": "USD",
      "shipping_method": "UPS01",
      "estimated_cost": 17.6
    }
  ]
}

Response Body Explanation

Attribute Name	Type	Description
code	Integer	Response code: 200 successful, 400/500 failed
data	List	return value list of cost for different shipping methods
currency	String	Currency code
shipping_method	String	Shipping method name
estimated_cost	Float	estimated shipping cost. This is ONLY ESTIMATE and final quotation is determined once tracking number gets checked-in in the system.