Duties & Tariffs
When shipping internationally, various duties and tariffs may get applied to your packages depending on the country and type of product you are shipping. ShipEngine tells you exactly how much you can expect to pay. This is commonly referred to as the "fully landed shipping cost".
Example
To accurately calculate the duties, tariffs, and other taxes for your shipment, ShipEngine needs to know the Harmonized Tariff Codes of the products in your shipment. You also need to set the calculate_tax_amount: true
flag to opt-in to this feature since there is additional cost involved.
Example Request
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
POST /v1/rates HTTP/1.1Host: api.shipengine.comAPI-Key: __YOUR_API_KEY_HERE__Content-Type: application/json{"rate_options": {"carrier_ids": ["se-82785"],"calculate_tax_amount": true},"shipment": {"service_code": "usps_first_class_mail_international","customs": {"contents": "merchandise","non_delivery": "treat_as_abandoned","customs_items": [{"harmonized_tariff_code": "0901.21","country_of_manufacture": "US","country_of_origin": "US","quantity": 2,"description": "books","value": {"currency": "usd","amount": 100}}]},"ship_from": {"company_name": "Example Corp.","name": "John Doe","phone": "111-111-1111","address_line1": "4009 Marathon Blvd","address_line2": "Suite 300","city_locality": "Austin","state_province": "TX","postal_code": "78756","country_code": "US","address_residential_indicator": "no"},"ship_to": {"name": "Amanda Miller","phone": "20 5555 5555","address_line1": "77 Netherpark Crescent","address_line2": "Suite 100","city_locality": "London","state_province": "N/A","postal_code": "ABC 123","country_code": "GB","address_residential_indicator": "yes"},"packages": [{"weight": {"value": 9.6,"unit": "ounce"},"dimensions": {"unit": "inch","length": 12,"width": 7.1,"height": 6}}]}}
Example Response
The tax_amount
field in the response represents the total duties, tariffs, and other taxes that will be applied to this shipment.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253
{"rate_response": {"rates": [{"rate_id": "se-5592488","rate_type": "shipment","carrier_id": "se-82785","shipping_amount": {"currency": "usd","amount": 23.28},"insurance_amount": {"currency": "usd","amount": 0.0},"confirmation_amount": {"currency": "usd","amount": 0.0},"other_amount": {"currency": "usd","amount": 0.0},"tax_amount": {"currency": "usd","amount": 0.0},"zone": null,"package_type": "package","delivery_days": null,"guaranteed_service": false,"estimated_delivery_date": null,"carrier_delivery_days": null,"ship_date": "2020-10-21T00:00:00Z","negotiated_rate": false,"service_type": "USPS First Class Mail Intl","service_code": "usps_first_class_mail_international","trackable": false,"carrier_code": "stamps_com","carrier_nickname": "Z - Test Stamps.com Account","carrier_friendly_name": "Stamps.com","validation_status": "valid","warning_messages": [],"error_messages": []},{"rate_id": "se-5592489","rate_type": "shipment","carrier_id": "se-82785","shipping_amount": {"currency": "usd","amount": 53.34},"insurance_amount": {"currency": "usd","amount": 0.0},"confirmation_amount": {"currency": "usd","amount": 0.0},"other_amount": {"currency": "usd","amount": 0.0},"tax_amount": {"currency": "usd","amount": 0.0},"zone": null,"package_type": "package","delivery_days": 10,"guaranteed_service": false,"estimated_delivery_date": "2020-10-31T00:00:00Z","carrier_delivery_days": "6 - 10","ship_date": "2020-10-21T00:00:00Z","negotiated_rate": false,"service_type": "USPS Priority Mail Intl","service_code": "usps_priority_mail_international","trackable": false,"carrier_code": "stamps_com","carrier_nickname": "Z - Test Stamps.com Account","carrier_friendly_name": "Stamps.com","validation_status": "valid","warning_messages": [],"error_messages": []},{"rate_id": "se-5592490","rate_type": "shipment","carrier_id": "se-82785","shipping_amount": {"currency": "usd","amount": 71.6000},"insurance_amount": {"currency": "usd","amount": 0.0},"confirmation_amount": {"currency": "usd","amount": 0.0},"other_amount": {"currency": "usd","amount": 0.0},"tax_amount": {"currency": "usd","amount": 0.0},"zone": null,"package_type": "medium_flat_rate_box","delivery_days": 10,"guaranteed_service": false,"estimated_delivery_date": "2020-10-31T00:00:00Z","carrier_delivery_days": "6 - 10","ship_date": "2020-10-21T00:00:00Z","negotiated_rate": false,"service_type": "USPS Priority Mail Intl","service_code": "usps_priority_mail_international","trackable": false,"carrier_code": "stamps_com","carrier_nickname": "Z - Test Stamps.com Account","carrier_friendly_name": "Stamps.com","validation_status": "valid","warning_messages": [],"error_messages": []}],"invalid_rates": [],"rate_request_id": "se-702570","shipment_id": "se-6407542","created_at": "2020-10-21T15:10:10.0994241Z","status": "completed","errors": []},"shipment_id": "se-6407542","carrier_id": "se-82785","service_code": "usps_first_class_mail_international","external_shipment_id": null,"ship_date": "2020-10-21T00:00:00Z","created_at": "2020-10-21T15:10:08.63Z","modified_at": "2020-10-21T15:10:08.567Z","shipment_status": "pending","ship_to": {"name": "Amanda Miller","phone": "20 5555 5555","company_name": null,"address_line1": "77 Netherpark Crescent","address_line2": "Suite 100","address_line3": null,"city_locality": "London","state_province": "N/A","postal_code": "ABC 123","country_code": "GB","address_residential_indicator": "yes"},"ship_from": {"name": "John Doe","phone": "111-111-1111","company_name": "Example Corp.","address_line1": "4009 Marathon Blvd","address_line2": "Suite 300","address_line3": null,"city_locality": "Austin","state_province": "TX","postal_code": "78756","country_code": "US","address_residential_indicator": "unknown"},"warehouse_id": null,"return_to": {"name": "John Doe","phone": "111-111-1111","company_name": "Example Corp.","address_line1": "4009 Marathon Blvd","address_line2": "Suite 300","address_line3": null,"city_locality": "Austin","state_province": "TX","postal_code": "78756","country_code": "US","address_residential_indicator": "unknown"},"confirmation": "none","customs": {"contents": "merchandise","customs_items": [{"customs_item_id": "se-582249","description": "books","quantity": 2,"value": 100.00,"harmonized_tariff_code": "0901.21","country_of_origin": "US","unit_of_measure": null}],"non_delivery": "treat_as_abandoned"},"external_order_id": null,"order_source_code": null,"advanced_options": {"bill_to_account": null,"bill_to_country_code": null,"bill_to_party": null,"bill_to_postal_code": null,"contains_alcohol": false,"delivered_duty_paid": false,"non_machinable": false,"saturday_delivery": false,"dry_ice": false,"dry_ice_weight": null,"freight_class": null,"custom_field1": null,"custom_field2": null,"custom_field3": null,"collect_on_delivery": null},"insurance_provider": "none","tags": [],"packages": [{"package_code": "package","weight": {"value": 9.60,"unit": "ounce"},"dimensions": {"unit": "inch","length": 12.00,"width": 7.10,"height": 6.00},"insured_value": {"currency": "usd","amount": 0.00},"label_messages": {"reference1": null,"reference2": null,"reference3": null},"external_package_id": null}],"total_weight": {"value": 9.60,"unit": "ounce"},"items": []}