Calculate Landed Cost

This endpoint calculates the total landed cost of a shipment. To retrieve the landed cost, send a POST request to the landed cost endpoint using the same payload as required for the create shipment request. This will return the full breakdown of costs, including taxes, duties, and shipping fees, providing an accurate total cost for the shipment.

API Reference

POST https://sandbox.staging.sendbox.co/shipping/landed_cost_estimate

Headers

Name	Value
Content-Type	application/json
Authorization	authorization-token

Body

Name	Type	Description
origin	object	Senders details
destination	object	Recipient details
weight	float	Weight of package
items	array	An array of objects that contain: - name [String] - weight [Float] - item_type_code [String optional] - hts_code [String optional] - description [String] - quantity [Integer] - value [Float]
incoming_option	string	set to either pickup or dropoff
pickup_date	date	date in ISO format
total_value	float	value of shipment
service_code	string	can be set to either international, nation-wide, or local.
package_type	string	package type
channel_code	string	channel the request is being made from; in this case set it to api
region	string	region the shipment is being shipped from.
callback_url	string	a webhook url to get the tracking update.
hts_code	string	pass in the item code to match it's description.

Response

200

{
    "customs_option": "sender",
    "dimension": {
        "length": 1.0,
        "width": 1.0,
        "height": 1.0
    },
    "incoming_option": "pickup",
    "estimate": {
        "code": "duties_and_taxes",
        "name": "Duties and taxes",
        "description": "import duties and taxes",
        "value": 18.93,
        "breakdown": [
            {
                "code": "duties",
                "name": "Duties",
                "description": "",
                "value": 0.0
            },
            {
                "code": "taxes",
                "name": "Taxes",
                "description": "",
                "value": 12.22
            },
            {
                "code": "fees",
                "name": "Fees",
                "description": "",
                "value": 6.71
            }
        ],
        "exchange_rate": 1669.025
    },
    "weight": 0.2,
    "currency": "NGN",
    "service_code": "standard",
    "origin": {
        "country": "NG",
        "lat": 6.56,
        "post_code": "102216",
        "first_name": "Emotu",
        "state": "abuja",
        "city": "maitama",
        "lng": 3.37
    },
    "destination": {
        "country": "GB",
        "lat": 37.81,
        "post_code": "94612",
        "first_name": "Ubani",
        "state": "london",
        "city": "london",
        "last_name": "Balogun",
        "lng": -122.27
    },
    "items": [
        {
            "name": "African Wax Fabrics - Orange Lace Fabric that is Not Woven",
            "item_type": "herbal_tea",
            "value": 100000.0,
            "quantity": 4,
            "weight": 0.5,
            "hts_code": "1211.90.8980",
            "disclaim": true
        }
    ],
    "service_type": "international",
    "total_value": 100000.0,
    "pickup_date": "2023-07-20T07:17:10.582Z",
    "package_type": "general",
    "region": "NG",
    "instance_id": "6136dfa6a1ab9d318bcfcb94",
    "user_id": "61f3f297f0bb8f001a8a34e0",
    "entity_id": null
}