Size and Weight

Accuracy is Key

Strive to be as accurate as possible when shipping! This will affect the availability of your chosen service. If the carrier has the ability to quote, The more accurate your information is, the better the rate quote you will receive from the Carriers.

Additionally, if the shipping information is incorrect, It may lead to the failure of the buy order, if the fluke buy order is successful, most carriers will follow up with a charge to make up the difference. This may result in your package being held until the extra delivery cost is paid by you or the recipient.

Note：The European logistics company's size and weight decimals will be rounding to the nearest integer by the logistics center. For US logistics companies，FedEx employs rounding down logic.UPS is rounded up by the logistics company itself: for weight, it is rounded up, and for size, it is rounding to the nearest integer.

The Basics

Weight

Weight inside of a shipment's packages object is required.

Property	Description
unit	enumerated string, required KG, LB
value	decimal, required Weight in the unit specified.

Different carriers have different requirements for the weight field.

• FedEx
  For weight and currency value/amount, only two explicit decimal places are allowed. At present, the logistics center defaults to packing YOUR_PACKAGING, and the maximum weight of a single package can reach 150lbs/68KG.
• UPS
  Package weight up to 70 kilograms or 150 pounds. do not support decimals.
• Evri
  Package weight up to 15 kilograms or 33 pounds. only two explicit decimal places are allowed.
• Whitsl
  For weight, only three explicit decimal places are allowed. Different logistics service limits are different. See service description for details
• DPD_UK
  Package weight up to 30 kilograms or 66 pounds. only three explicit decimal places are allowed.
• DPD_DE
  Package weight up to 31.5 kilograms or 69 pounds. only three explicit decimal places are allowed.
• GLS
  Package weight up to 40 kilograms or 88 pounds. There is no requirement for the number of decimal places in the document.
• GEL
  Package weight up to 1000 kilograms or 2205 pounds. only three explicit decimal places are allowed.
• AMAZON
  Package weight up to 50 pounds.

Dimensions

Optionally, you can specify the dimensions of each package in the shipment.

Property	Description
unit	enumerated string, required CM, IN
length	decimal, required Length in the unit specified.
width	decimal, required Width in the unit specified.
height	decimal, required Height in the unit specified.

Add the objects directly into the shipment object. Use this same format to get shipping rates as well.

Different carriers have different requirements for the dimensions field.

• FedEx
  length, width and height – do not support decimals.

  • Ground : The maximum size limit for a package is 108' in length, or 165 total inches in length plus girth (L+2W+2H).
  • U.S. Express Shipping : The maximum size limit for a package is 119' in length, or 165 total inches in length plus girth (L+2W+2H).

  Note: Package measurements:Although not required for FedEx Express and FedEx Ground shipments, entering package measurements helps FedEx provide the most accurate rate quote possible.You are required to enter skid measurements for FedEx Express Freight shipments.
  Length: The longest side of your package.
  Width: The next longest side of your package.
  Height: The shortest side of your package.
  
  

  

• UPS
  length, width and height – do not support decimals. The maximum size limit for a package is 108' in length, or 165 total inches in length plus girth (L+2W+2H).

• Evri
  no information.

• Whitsl
  length, width and height – do not support decimals. Different logistics service limits are different. See service description for details

• DPD_UK
  no information.

• DPD_DE
  length, width and height - only two explicit decimal places are allowed. length up to 175cm, width and height meets the maximum circumference limit of 300cm.

• GLS
  no information.

• GEL
  length, width and height - only two explicit decimal places are allowed. length up to 610cm, width up to 200cm, height up to 225cm.

• AMAZON
  length, width and height —length up to 59inches, width and height up to 33inches, girth exceeding 130 inches. Length is defined as the longest side of the parcel, and girth is defined as G=L+2(W+H).

Example

POST /v1/shipment

This example shows how to ship a package with a shipping weight of 10.8425 kilograms, and box dimensions of 50.56 x 50.23 x 50.58 inches.

POST /v1/shipment HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json

{
    "serviceType": "__YOUR_SERVICE_TYPE__",
    "carrierId": "__YOUR_CARRIER_ID__",
    "shipper": {
        "address": {
            ...
        },
        "contact": {
            ...
        }
    },
    "recipient": {
        "address": {
            ...
        },
        "contact": {
            ...
        }
    },
    "itemLines": [
        {
            "itemTransactionId": "itemTransactionId",
            "itemCode": "itemCode",
            "weight": {
                "units": "kg",
                "value": 10.8425
            },
            "customerReference": {
                "ref1": "ref1"
            },
            "dimensions": {
                "length": 50.56,
                "units": "in",
                "width": 50.23,
                "height": 50.58
            }
        }
    ],
    "labelSpecification": {
        ...
    }
}