API Overview
This API returns the complete set of taxes that apply when a specific product (identified by its Harmonized System code) is exported from one country and imported into another. Because the tax picture depends on three things (what is shipped, where it ships from, and where it ships to), this API takes three parameters: the origin (export) country, the destination (import) country, and the HS code (6-digit minimum, up to 10-digit national extensions). The origin country matters because it drives both preferential FTA eligibility and origin-specific trade remedies such as anti-dumping duties and Section 301 tariffs. The response covers the MFN applied rate, the calculation basis (ad valorem / specific / compound), the preferential rate the origin qualifies for under any applicable FTA, trade-remedy duties tied to the origin, safeguard measures, import VAT/GST, special destination-country taxes layered on top (such as Brazil's ICMS and IPI or India's Social Welfare Surcharge), and critical non-tariff considerations like de minimis thresholds, import licensing, quotas, and CITES restrictions. Freight forwarders, customs brokers, ERP systems, cross-border ecommerce platforms, and logistics software rely on this API for landed-cost calculation, sourcing decisions, and clearance preparation.
Full Tax Stack
Every response includes MFN duty, duty basis, the applicable preferential rate, trade-remedy duties, safeguards, import VAT/GST, and special destination taxes: the complete picture needed for accurate landed-cost calculation on a given route.
Origin-Aware Trade Remedies
Anti-dumping duties, countervailing duties, and Section 301 tariffs depend on where goods originate. By taking the origin country as an input, the API surfaces exactly which trade-defense measures apply to your specific route, plus the preferential rate that origin qualifies for.
Non-Tariff Restrictions
Import licensing requirements, tariff-rate quotas, CITES permits, dual-use export controls, SPS certificates, and outright bans are surfaced in a dedicated field, often the actual shipment blocker rather than the duty rate itself.
Premium API
This is a premium API that uses advanced AI analysis across national tariff schedules, WTO concession bindings, free trade agreements, customs authority publications, anti-dumping and countervailing orders, and Section 301 actions to provide the complete set of taxes for any origin, destination, and HS-code combination.
Sample Results
| Field | Example Value | Description |
|---|---|---|
OriginCountry |
China | Canonical English name of the exporting/origin country |
DestinationCountry |
United States | Canonical English name of the importing/destination country |
CountryCodeISO2 |
US | ISO 3166-1 alpha-2 code of the destination country |
HSCode |
8471.30.00 | Normalized HS code in canonical dotted format |
HSCodeDescription |
Portable automatic data processing machines, weight not exceeding 10 kg | Clear English description of what the HS code classifies |
MFNAppliedRate |
0% (WTO Information Technology Agreement) | MFN applied tariff rate for the default case (no FTA) |
DutyBasis |
Ad valorem | How the duty is calculated (Ad valorem / Specific / Compound / Mixed) |
ApplicablePreferentialRate |
No preferential agreement between China and the United States; MFN rate applies | The rate the named origin qualifies for under any applicable FTA, with eligibility stated |
TradeRemedyDuties |
Section 301: 25% additional on goods originating from China (List 1); verify current list coverage for this HS code | Origin-specific anti-dumping, countervailing, and Section 301 measures |
SafeguardMeasures |
None applicable | Global or country-specific safeguard tariffs and TRQ safeguards |
ImportVATOrGST |
No federal VAT or GST; state and local sales taxes apply at point of sale | Destination VAT or GST applied on the dutiable value |
SpecialOrAdditionalTaxes |
Merchandise Processing Fee approximately 0.3464%; Harbor Maintenance Fee 0.125% on ocean shipments | Destination-specific indirect taxes and surcharges layered on top of duty and VAT/GST |
DeMinimisThreshold |
US: $800 de minimis for duty and most federal taxes under Section 321 | Customs value threshold below which duty and/or tax is waived |
RestrictionsNotes |
No unusual restrictions; FCC equipment authorization required for radio-frequency devices | Import licensing, quotas, CITES, dual-use controls, SPS requirements |
EffectivePeriod |
2025 US Harmonized Tariff Schedule Revision 2 (USITC) | Tariff schedule version and year |
CustomsAuthorityReferenceURL |
https://hts.usitc.gov/ | URL of the destination country's tariff lookup tool |
API Details
Endpoint
https://api.interzoid.com/getcustomsdutyrates
Request Format
This API takes three required parameters: origin (export) country, destination (import) country, and HS code.
https://api.interzoid.com/getcustomsdutyrates?license=[licensekey]&origin=[origin country]&lookup=[destination country]&hscode=[6-to-10-digit HS code]
The origin parameter is the export country (where goods ship from). The lookup parameter is the destination country (where goods are imported to). URL-encode any country name that contains a space (for example, El%20Salvador or Dominican%20Republic).
Sample Request
https://api.interzoid.com/getcustomsdutyrates?license=fh5hs7*****&origin=China&lookup=United%20States&hscode=8471.30
Sample Response
{ "OriginCountry": "China", "DestinationCountry": "United States", "CountryCodeISO2": "US", "HSCode": "8471.30.00", "HSCodeDescription": "Portable automatic data processing machines, weight not exceeding 10 kg, consisting of at least a CPU, keyboard, and display", "MFNAppliedRate": "0% (WTO Information Technology Agreement binding)", "DutyBasis": "Ad valorem", "ApplicablePreferentialRate": "No preferential agreement between China and the United States; MFN rate applies", "TradeRemedyDuties": "Section 301 additional tariffs apply to many goods of Chinese origin; verify current list coverage and rate for this specific HS code, as List allocations and rates have changed over successive actions", "SafeguardMeasures": "None applicable for this HS code", "ImportVATOrGST": "No federal VAT or GST; state and local sales taxes apply at point of sale", "SpecialOrAdditionalTaxes": "Merchandise Processing Fee approximately 0.3464% ad valorem (minimum and maximum apply); Harbor Maintenance Fee 0.125% on ocean shipments", "DeMinimisThreshold": "US: $800 de minimis for duty and most federal taxes under Section 321 (subject to ongoing policy changes affecting Chinese-origin goods)", "RestrictionsNotes": "FCC equipment authorization required for radio-frequency devices; country of origin marking required; lithium battery shipments subject to dangerous goods rules", "EffectivePeriod": "2025 US Harmonized Tariff Schedule Revision 2 (USITC)", "CustomsAuthorityReferenceURL": "https://hts.usitc.gov/", "Code": "Success", "Credits": "20220031" }
cURL Example (with API key in header)
curl --header "x-api-key: fh5hs7*****" "https://api.interzoid.com/getcustomsdutyrates?origin=China&lookup=United%20States&hscode=8471.30"
Additional Examples
Here are additional real-world examples showing how the API handles the same product on different routes, where the origin country changes the preferential rate, the trade-remedy exposure, and the special destination taxes that apply:
China to United States (T-Shirts) Section 301
{ "OriginCountry": "China", "DestinationCountry": "United States", "CountryCodeISO2": "US", "HSCode": "6109.10.00", "HSCodeDescription": "T-shirts, singlets, tank tops and similar garments, knitted or crocheted, of cotton", "MFNAppliedRate": "16.5% ad valorem", "DutyBasis": "Ad valorem", "ApplicablePreferentialRate": "No preferential agreement between China and the United States; MFN rate applies in full", "TradeRemedyDuties": "Section 301 additional tariff applies to cotton apparel of Chinese origin (List 4A); verify the current rate for this HS code as List 4A rates have been adjusted over time. Stacked on top of the MFN rate", "SafeguardMeasures": "None applicable", "ImportVATOrGST": "No federal VAT or GST; state and local sales taxes apply at point of sale", "SpecialOrAdditionalTaxes": "Merchandise Processing Fee 0.3464% ad valorem (minimum $32.71, maximum $634.62 per entry); Harbor Maintenance Fee 0.125% on ocean shipments", "DeMinimisThreshold": "US: $800 de minimis under Section 321, though Chinese-origin goods are subject to ongoing policy changes that may remove this benefit; verify current status", "RestrictionsNotes": "Textile labeling under the FTC Textile Fiber Products Identification Act; country of origin marking required; UFLPA rebuttable presumption applies to cotton linked to Xinjiang", "EffectivePeriod": "2025 US Harmonized Tariff Schedule Revision 2 (USITC)", "CustomsAuthorityReferenceURL": "https://hts.usitc.gov/", "Code": "Success", "Credits": "20220006" }
India to United States (Same T-Shirts) Different Origin
{ "OriginCountry": "India", "DestinationCountry": "United States", "CountryCodeISO2": "US", "HSCode": "6109.10.00", "HSCodeDescription": "T-shirts, singlets, tank tops and similar garments, knitted or crocheted, of cotton", "MFNAppliedRate": "16.5% ad valorem", "DutyBasis": "Ad valorem", "ApplicablePreferentialRate": "No US-India FTA; apparel categories are generally excluded from GSP, so the MFN rate applies. Verify current program status", "TradeRemedyDuties": "None applicable for Indian-origin cotton t-shirts; Section 301 measures target Chinese origin and do not apply to this route", "SafeguardMeasures": "None applicable", "ImportVATOrGST": "No federal VAT or GST; state and local sales taxes apply at point of sale", "SpecialOrAdditionalTaxes": "Merchandise Processing Fee 0.3464% ad valorem (minimum $32.71, maximum $634.62 per entry); Harbor Maintenance Fee 0.125% on ocean shipments", "DeMinimisThreshold": "US: $800 de minimis for duty and most federal taxes under Section 321", "RestrictionsNotes": "Textile labeling under the FTC Textile Fiber Products Identification Act; country of origin marking required", "EffectivePeriod": "2025 US Harmonized Tariff Schedule Revision 2 (USITC)", "CustomsAuthorityReferenceURL": "https://hts.usitc.gov/", "Code": "Success", "Credits": "20219981" }
China to Brazil (Steel Fasteners) Special Taxes
{ "OriginCountry": "China", "DestinationCountry": "Brazil", "CountryCodeISO2": "BR", "HSCode": "7318.15.00", "HSCodeDescription": "Threaded screws and bolts of iron or steel, whether or not with their nuts or washers", "MFNAppliedRate": "Mercosur Common External Tariff applies; verify current TEC rate for this NCM code", "DutyBasis": "Ad valorem", "ApplicablePreferentialRate": "No preferential agreement between China and Brazil; Mercosur Common External Tariff applies in full", "TradeRemedyDuties": "Brazil maintains anti-dumping measures on various steel products of Chinese origin; verify whether an active anti-dumping order covers this specific HS code and origin via CAMEX/SECEX", "SafeguardMeasures": "None typically applicable; confirm current SECEX investigations", "ImportVATOrGST": "Not a single VAT; Brazil applies a layered federal and state tax stack on imports (see special taxes)", "SpecialOrAdditionalTaxes": "IPI (federal excise, rate varies by product); PIS-Importacao and COFINS-Importacao; ICMS (state-level, commonly 17-19%); AFRMM merchant marine surcharge on ocean freight. These layer on top of the customs duty", "DeMinimisThreshold": "Brazil: low-value relief is limited and applies mainly to individual-to-individual shipments; commercial imports are taxed regardless of value", "RestrictionsNotes": "Import licensing via Siscomex may be required; product conformity and INMETRO certification can apply to certain fasteners", "EffectivePeriod": "Brazil TEC Mercosur, current year schedule", "CustomsAuthorityReferenceURL": "https://portalunico.siscomex.gov.br/", "Code": "Success", "Credits": "20219956" }
Spain to Germany (Intra-EU Wine) Customs Union
{ "OriginCountry": "Spain", "DestinationCountry": "Germany", "CountryCodeISO2": "DE", "HSCode": "2204.21.00", "HSCodeDescription": "Wine of fresh grapes, other than sparkling wine, in containers holding 2 litres or less", "MFNAppliedRate": "Not applicable; Spain and Germany are both EU member states, so this is an intra-union movement with no customs duty", "DutyBasis": "Not applicable (intra-EU)", "ApplicablePreferentialRate": "Not applicable; goods in free circulation move within the EU single market without customs duty. No import declaration or FTA claim is required between member states", "TradeRemedyDuties": "None; trade-remedy measures do not apply to intra-EU movements", "SafeguardMeasures": "None applicable", "ImportVATOrGST": "No import VAT on the intra-EU movement itself; German VAT (19%) is handled through intra-community acquisition and reverse-charge rules rather than at a customs border", "SpecialOrAdditionalTaxes": "German alcohol duty rules apply on still wine per national excise law; movements of duty-suspended excise goods travel under EMCS with an electronic administrative document", "DeMinimisThreshold": "Not applicable to intra-EU movements; no customs de minimis between member states", "RestrictionsNotes": "No customs restrictions on the intra-EU movement; EU wine labeling rules and excise documentation (EMCS) apply", "EffectivePeriod": "EU single market rules, current year", "CustomsAuthorityReferenceURL": "https://trade.ec.europa.eu/access-to-markets/", "Code": "Success", "Credits": "20219931" }
Try the API within a Web Application
Interactive Application
See the API in an easy-to-use interactive browser application. Simply provide the origin country, destination country, and HS code, and receive formatted results instantly.
Try it NowAdditional Resources
Try this API Interactively
Our API interactive usage tool enables you to try this API interactively with a user interface and without writing code. The tool is available for all of our APIs.
Try it NowUse this API in a High-Performance, No-Code, Cloud Batch Mode
Our Enrich Wizard no-code batch tool enables you to quickly use this API within our parallel-processing Cloud platform, enriching text files (CSV/TSV) with a few clicks and without writing code. This is the fastest and easiest way to use this API with higher volumes of data, enabling results in minutes
Start NowInternationalize Results with Multilingual Support
Add a language parameter value to API calls to receive results in selected languages.
Learn More