WOwove
Tariffs

Look up duty rates by HS code

Look up import duty rates for a specific HS/HTS code.

Features:

  • Supports US, EU, Canada, and Australia tariff schedules
  • Returns MFN rates, preferential rates, and additional duties (Section 301, 232, etc.)
  • Calculates landed cost including customs fees
  • Supports FTA program selection
  • Customer-specific tariff overrides are automatically applied

HS Code Format:

  • US: 10-digit HTS code (e.g., "6209205000" or "6209.20.50.00")
  • Other countries: 4-12 digit HS code

Additional Duties: For products subject to Section 232 tariffs (steel/aluminum derivatives), you may need to provide component percentages via componentValues.

get/api/v1/external/tariffs/lookup

Request

Query parameters

hsCodestring required

HS/HTS code to look up (e.g., "6209205000" or "6209.20.50.00")

originCountrystring required

Origin country code (2-letter ISO)

destinationCountrystring required

Destination country code (2-letter ISO)

customsValuenumber

Customs value for duty calculation

currencystring

Currency code for calculations

entryDatestring date

Entry date for historical rate lookup (ISO date)

dateOfLoadingstring date

Date of loading for historical rate lookup (used if entryDate not provided)

transportMode'ocean' | 'air' | 'land' | 'rail'

Transport mode for customs fee calculations

componentValuesstring

JSON object of component values for Section 232 calculations (e.g., '{"aluminum": 30}' for 30% aluminum content)

exclusionCodesstring

JSON array of importer-claimed codes to apply. Two kinds share this parameter:

  • Chapter 99 exclusion codes (e.g. 9903.01.21).
  • A Chapter 98 provision the entry is claimed under (US destination). Send 9801.00.10 for US-origin goods returning to the US (American goods returned): the base duty becomes 0%, duties that Chapter 98 waives are dropped, and the merchandise processing fee is exempt (19 CFR 24.23(c)(1)(i)). 9802.00.80 and 9802.00.40/.50/.60 reduce the value duty is assessed on and need the deducted value in componentValues (usContentValue or repairValue).

A claim is the importer's attestation; the response reports how it was applied in appliedCh98Provision. With originCountry=US and no Chapter 98 claim, the ordinary rate is charged and warnings says so. US-origin goods pay the general (MFN) rate only: no Chapter 99 additional duty is applied to them.

includeFtaOptions'true' | 'false'

Whether to include FTA options in the response

applyFtaProgramstring

FTA program code to apply (e.g., 'US_AU_FTA')

weightKgnumber

Weight in kilograms for per-kg fee calculations

Response

Tariff lookup successful

successboolean

Example response

{
  "success": true,
  "data": {
    "tariffLine": {
      "code": "8471.60.90.50",
      "description": "Other data processing equipment",
      "hs6": "847160",
      "uomPrimary": "NO"
    },
    "applicableRate": {
      "regime": "MFN",
      "programCode": "US_MFN",
      "rateType": "AD_VALOREM",
      "formulaDescription": "Free"
    },
    "importProhibitions": [
      {
        "description": "Excluded from importation into the United States — Canadian alcoholic beverages (Proclamation of September 8, 2026, section 338(a))",
        "effectiveFrom": "2026-09-29",
        "authority": "section_338",
        "condition": "packaged",
        "supersededDuties": [
          "9903.03.12"
        ]
      }
    ],
    "appliedCh98Provision": {
      "code": "9801.00.10"
    },
    "warnings": [
      {
        "suggestedClaimCode": "9801.00.10"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.