{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/rates/taxes","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/rates/taxes","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/rates/taxes","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Duties & Tariffs","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"duties--tariffs","__idx":0},"children":["Duties & Tariffs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When shipping internationally, various duties and tariffs may get applied to your packages depending on the destination country and type of product you are shipping. ShipStation API tells you exactly how much you can expect to pay. This is commonly referred to as the \"fully landed shipping cost\"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.shipengine.com/contact/"},"children":["Contact our sales team"]}," for details about the pricing of this feature."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request--response","__idx":1},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To accurately calculate the duties, tariffs, and other taxes for your shipment, ShipStation API needs to know the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/Harmonized_System"},"children":["Harmonized Tariff Codes"]}," of the products in your shipment. You also need to set the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calculate_tax_amount: true"]}," flag to opt-in to this feature since there is additional cost involved."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/rates HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"rate_options\": {\n    \"carrier_ids\": [\n      \"se-82785\"\n    ],\n    \"calculate_tax_amount\": true\n  },\n  \"shipment\": {\n    \"service_code\": \"usps_first_class_mail_international\",\n    \"customs\": {\n      \"contents\": \"merchandise\",\n      \"non_delivery\": \"treat_as_abandoned\",\n      \"customs_items\": [\n        {\n          \"harmonized_tariff_code\": \"0901.21\",\n          \"country_of_manufacture\": \"US\",\n          \"country_of_origin\": \"US\",\n          \"quantity\": 2,\n          \"description\": \"rare books\",\n          \"value\": {\n            \"currency\": \"usd\",\n            \"amount\": 1000\n          }\n        }\n      ]\n    },\n    \"ship_from\": {\n      \"company_name\": \"Example Corp.\",\n      \"name\": \"John Doe\",\n      \"phone\": \"111-111-1111\",\n      \"address_line1\": \"4009 Marathon Blvd\",\n      \"address_line2\": \"Suite 300\",\n      \"city_locality\": \"Austin\",\n      \"state_province\": \"TX\",\n      \"postal_code\": \"78756\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"no\"\n    },\n    \"ship_to\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"20 5555 5555\",\n      \"address_line1\": \"77 Netherpark Crescent\",\n      \"address_line2\": \"Suite 100\",\n      \"city_locality\": \"London\",\n      \"state_province\": \"N/A\",\n      \"postal_code\": \"ABC 123\",\n      \"country_code\": \"GB\",\n      \"address_residential_indicator\": \"yes\"\n    },\n    \"packages\": [\n      {\n        \"weight\": {\n          \"value\": 9.6,\n          \"unit\": \"ounce\"\n        },\n        \"dimensions\": {\n          \"unit\": \"inch\",\n          \"length\": 12,\n          \"width\": 7.1,\n          \"height\": 6\n        }\n      }\n    ]\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example Response"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_amount"]}," field in the response represents the total duties, tariffs, and other taxes that will be applied to this shipment."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"rate_response\": {\n        \"rates\": [\n            {\n                \"rate_id\": \"se-5592488\",\n                \"rate_type\": \"shipment\",\n                \"carrier_id\": \"se-82785\",\n                \"shipping_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 23.28\n                },\n                \"insurance_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 0.0\n                },\n                 \"confirmation_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 0.0\n                },\n                \"other_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 0.0\n                },\n                \"tax_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 20.1\n                },\n                \"rate_details\": [\n                    {\n                        \"rate_detail_type\": \"shipping\",\n                        \"carrier_description\": null,\n                        \"carrier_billing_code\": \"Base Rate\",\n                        \"carrier_memo\": null,\n                        \"amount\": {\n                            \"currency\": \"usd\",\n                            \"amount\": 23.28\n                        },\n                        \"billing_source\": \"Carrier\"\n                    },\n                    {\n                        \"rate_detail_type\": \"tax\",\n                        \"carrier_description\": null,\n                        \"carrier_billing_code\": \"\",\n                        \"carrier_memo\": null,\n                        \"amount\": {\n                            \"currency\": \"usd\",\n                            \"amount\": 20.10\n                        },\n                        \"billing_source\": \"Product\"\n                    }\n                ],\n                \"zone\": null,\n                \"package_type\": \"package\",\n                \"delivery_days\": null,\n                \"guaranteed_service\": false,\n                \"estimated_delivery_date\": null,\n                \"carrier_delivery_days\": null,\n                \"ship_date\": \"2020-10-21T00:00:00Z\",\n                \"negotiated_rate\": false,\n                \"service_type\": \"USPS First Class Mail Intl\",\n                \"service_code\": \"usps_first_class_mail_international\",\n                \"trackable\": false,\n                \"carrier_code\": \"stamps_com\",\n                \"carrier_nickname\": \"Z - Test Stamps.com Account\",\n                \"carrier_friendly_name\": \"Stamps.com\",\n                \"validation_status\": \"valid\",\n                \"warning_messages\": [],\n                \"error_messages\": []\n            },\n            {\n                \"rate_id\": \"se-5592489\",\n                \"rate_type\": \"shipment\",\n                \"carrier_id\": \"se-82785\",\n                \"shipping_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 53.34\n                },\n                \"insurance_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 0.0\n                },\n                \"confirmation_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 0.0\n                },\n                \"other_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 0.0\n                },\n                \"tax_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 20.1\n                },\n                \"rate_details\": [\n                    {\n                        \"rate_detail_type\": \"shipping\",\n                        \"carrier_description\": null,\n                        \"carrier_billing_code\": \"Base Rate\",\n                        \"carrier_memo\": null,\n                        \"amount\": {\n                            \"currency\": \"usd\",\n                            \"amount\": 53.34\n                        },\n                        \"billing_source\": \"Carrier\"\n                    },\n                    {\n                        \"rate_detail_type\": \"tax\",\n                        \"carrier_description\": null,\n                        \"carrier_billing_code\": \"\",\n                        \"carrier_memo\": null,\n                        \"amount\": {\n                            \"currency\": \"usd\",\n                            \"amount\": 20.10\n                        },\n                        \"billing_source\": \"Product\"\n                    }\n                ],\n                \"zone\": null,\n                \"package_type\": \"package\",\n                \"delivery_days\": 10,\n                \"guaranteed_service\": false,\n                \"estimated_delivery_date\": \"2020-10-31T00:00:00Z\",\n                \"carrier_delivery_days\": \"6 - 10\",\n                \"ship_date\": \"2020-10-21T00:00:00Z\",\n                \"negotiated_rate\": false,\n                \"service_type\": \"USPS Priority Mail Intl\",\n                \"service_code\": \"usps_priority_mail_international\",\n                \"trackable\": false,\n                \"carrier_code\": \"stamps_com\",\n                \"carrier_nickname\": \"Z - Test Stamps.com Account\",\n                \"carrier_friendly_name\": \"Stamps.com\",\n                \"validation_status\": \"valid\",\n                \"warning_messages\": [],\n                \"error_messages\": []\n            },\n            {\n                \"rate_id\": \"se-5592490\",\n                \"rate_type\": \"shipment\",\n                \"carrier_id\": \"se-82785\",\n                \"shipping_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 71.6000\n                },\n                \"insurance_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 0.0\n                },\n                \"confirmation_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 0.0\n                },\n                \"other_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 0.0\n                },\n                \"tax_amount\": {\n                    \"currency\": \"usd\",\n                    \"amount\": 20.1\n                },\n                \"rate_details\": [\n                    {\n                        \"rate_detail_type\": \"shipping\",\n                        \"carrier_description\": null,\n                        \"carrier_billing_code\": \"Base Rate\",\n                        \"carrier_memo\": null,\n                        \"amount\": {\n                            \"currency\": \"usd\",\n                            \"amount\": 71.60\n                        },\n                        \"billing_source\": \"Carrier\"\n                    },\n                    {\n                        \"rate_detail_type\": \"tax\",\n                        \"carrier_description\": null,\n                        \"carrier_billing_code\": \"\",\n                        \"carrier_memo\": null,\n                        \"amount\": {\n                            \"currency\": \"usd\",\n                            \"amount\": 20.10\n                        },\n                        \"billing_source\": \"Product\"\n                    }\n                ],\n                \"zone\": null,\n                \"package_type\": \"medium_flat_rate_box\",\n                \"delivery_days\": 10,\n                \"guaranteed_service\": false,\n                \"estimated_delivery_date\": \"2020-10-31T00:00:00Z\",\n                \"carrier_delivery_days\": \"6 - 10\",\n                \"ship_date\": \"2020-10-21T00:00:00Z\",\n                \"negotiated_rate\": false,\n                \"service_type\": \"USPS Priority Mail Intl\",\n                \"service_code\": \"usps_priority_mail_international\",\n                \"trackable\": false,\n                \"carrier_code\": \"stamps_com\",\n                \"carrier_nickname\": \"Z - Test Stamps.com Account\",\n                \"carrier_friendly_name\": \"Stamps.com\",\n                \"validation_status\": \"valid\",\n                \"warning_messages\": [],\n                \"error_messages\": []\n            }\n        ],\n        \"invalid_rates\": [],\n        \"rate_request_id\": \"se-702570\",\n        \"shipment_id\": \"se-6407542\",\n        \"created_at\": \"2020-10-21T15:10:10.0994241Z\",\n        \"status\": \"completed\",\n        \"errors\": []\n    },\n    \"shipment_id\": \"se-6407542\",\n    \"carrier_id\": \"se-82785\",\n    \"service_code\": \"usps_first_class_mail_international\",\n    \"external_shipment_id\": null,\n    \"ship_date\": \"2020-10-21T00:00:00Z\",\n    \"created_at\": \"2020-10-21T15:10:08.63Z\",\n    \"modified_at\": \"2020-10-21T15:10:08.567Z\",\n    \"shipment_status\": \"pending\",\n    \"ship_to\": {\n        \"name\": \"Amanda Miller\",\n        \"phone\": \"20 5555 5555\",\n        \"company_name\": null,\n        \"address_line1\": \"77 Netherpark Crescent\",\n        \"address_line2\": \"Suite 100\",\n        \"address_line3\": null,\n        \"city_locality\": \"London\",\n        \"state_province\": \"N/A\",\n        \"postal_code\": \"ABC 123\",\n        \"country_code\": \"GB\",\n        \"address_residential_indicator\": \"yes\"\n    },\n    \"ship_from\": {\n        \"name\": \"John Doe\",\n        \"phone\": \"111-111-1111\",\n        \"company_name\": \"Example Corp.\",\n        \"address_line1\": \"4009 Marathon Blvd\",\n        \"address_line2\": \"Suite 300\",\n        \"address_line3\": null,\n        \"city_locality\": \"Austin\",\n        \"state_province\": \"TX\",\n        \"postal_code\": \"78756\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"unknown\"\n    },\n    \"warehouse_id\": null,\n    \"return_to\": {\n        \"name\": \"John Doe\",\n        \"phone\": \"111-111-1111\",\n        \"company_name\": \"Example Corp.\",\n        \"address_line1\": \"4009 Marathon Blvd\",\n        \"address_line2\": \"Suite 300\",\n        \"address_line3\": null,\n        \"city_locality\": \"Austin\",\n        \"state_province\": \"TX\",\n        \"postal_code\": \"78756\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"unknown\"\n    },\n    \"confirmation\": \"none\",\n    \"customs\": {\n        \"contents\": \"merchandise\",\n        \"customs_items\": [\n            {\n                \"customs_item_id\": \"se-582249\",\n                \"description\": \"rare books\",\n                \"quantity\": 2,\n                \"value\": 1000.00,\n                \"harmonized_tariff_code\": \"0901.21\",\n                \"country_of_origin\": \"US\",\n                \"unit_of_measure\": null\n            }\n        ],\n        \"non_delivery\": \"treat_as_abandoned\"\n    },\n    \"external_order_id\": null,\n    \"order_source_code\": null,\n    \"advanced_options\": {\n        \"bill_to_account\": null,\n        \"bill_to_country_code\": null,\n        \"bill_to_party\": null,\n        \"bill_to_postal_code\": null,\n        \"contains_alcohol\": false,\n        \"delivered_duty_paid\": false,\n        \"non_machinable\": false,\n        \"saturday_delivery\": false,\n        \"dry_ice\": false,\n        \"dry_ice_weight\": null,\n        \"freight_class\": null,\n        \"custom_field1\": null,\n        \"custom_field2\": null,\n        \"custom_field3\": null,\n        \"collect_on_delivery\": null\n    },\n    \"insurance_provider\": \"none\",\n    \"tags\": [],\n    \"packages\": [\n        {\n            \"package_code\": \"package\",\n            \"weight\": {\n                \"value\": 9.60,\n                \"unit\": \"ounce\"\n            },\n            \"dimensions\": {\n                \"unit\": \"inch\",\n                \"length\": 12.00,\n                \"width\": 7.10,\n                \"height\": 6.00\n            },\n            \"insured_value\": {\n                \"currency\": \"usd\",\n                \"amount\": 0.00\n            },\n            \"label_messages\": {\n                \"reference1\": null,\n                \"reference2\": null,\n                \"reference3\": null\n            },\n            \"external_package_id\": null\n        }\n    ],\n    \"total_weight\": {\n        \"value\": 9.60,\n        \"unit\": \"ounce\"\n    },\n    \"items\": []\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Duties & Tariffs","id":"duties--tariffs","depth":1},{"value":"Example Request & Response","id":"example-request--response","depth":2}],"frontmatter":{"seo":{"title":"Duties & Tariffs"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/rates/taxes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}