It requires a
Shipment authorization scope enabled on the API key.
ℹ️ Selecting a Specific Courier
If you have already used our Rates API, you can specify a specific Courier ID to assign a Courier to the Shipment, using the
selected_courier_id attribute. If you don’t pass in a Courier ID, we will return a list of all possible Rates to your new Shipment and assign the best value for money Courier to your Shipment.
ℹ️ Calculating Dimensions and Total Weight
If a parcel's
total_actual_weightis provided, it will prevail over the sum of the items' weights. If not provided, the items' weights are mandatory and will be used to calculate the total package dimensions.
Likewise, if the
boxobject is provided, its dimensions will prevail over all individual items' dimensions. If a box isn't specified, item dimensions are mandatory and we will used to determine the best box for the parcel.
Note: If the shipment contains an item with batteries,
item.actual_weightis mandatory regardless of whether
total_actual_weightis provided. This is because couriers require more accurate information on an item-level when shipping dangerous goods.