Gateway Lines Tariff

Calculate US import duty and landed cost estimates. Give hts_code when you know it and this returns the calculated base duty and trade actions (Section 301, Section 232, Section 338, AD/CVD and others), estimated duty, fees and import cost. When estimate_status is partial, AD/CVD is undetermined and the amounts are provisional; convey that the estimate is incomplete. Give product instead and it returns candidate HTS codes WITHOUT pricing, because the classification decides the duty and guessing it produces confidently wrong numbers: confirm the right code with the user, then call again with hts_code. The candidate step is not charged.

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "description": "Plain description, e.g. \"outdoor metal furniture\". Returns candidate codes to confirm, does not price. Provide this OR hts_code."
    },
    "hts_code": {
      "type": "string",
      "description": "Exact HTS rate line, 8 or 10 digits, e.g. \"9403.20.00.50\". Takes precedence over product. 4 and 6 digit headings cannot be priced."
    },
    "country_code": {
      "type": "string",
      "description": "ISO 2-letter country of ORIGIN (where the goods were made), e.g. \"CN\", \"CA\", \"VN\"."
    },
    "declared_value": {
      "type": "number",
      "description": "Customs value of the shipment in USD."
    },
    "shipment_mode": {
      "type": "string",
      "description": "Optional: \"ocean\" (default) or \"air\". Affects government fees only."
    }
  },
  "required": [
    "country_code",
    "declared_value"
  ]
}

{
  "type": "object",
  "properties": {
    "hts_code": {
      "type": "string",
      "description": "The HTS line the duty was calculated on."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Official description of that line."
    },
    "country": {
      "type": "object",
      "description": "Country of origin, as resolved."
    },
    "declared_value": {
      "type": "number",
      "description": "Customs value used, in USD."
    },
    "duty_breakdown": {
      "type": [
        "object",
        "null"
      ],
      "description": "Every trade action considered, keyed by authority (base_duty, section_301, section_232, section_338_canada and the rest). Each carries rate, applies, and often a reason and legal reference. An action with applies false and upcoming true is scheduled but not yet owed."
    },
    "total_duty_rate_pct": {
      "type": [
        "number",
        "null"
      ],
      "description": "Calculated duty estimate as a percentage of declared value. Read estimate_status before describing this as a complete estimate."
    },
    "total_duty_usd": {
      "type": [
        "number",
        "null"
      ],
      "description": "Calculated duty estimate in USD. When estimate_status.status is partial, this is provisional and is not the complete payable duty."
    },
    "estimate_status": {
      "type": [
        "object",
        "null"
      ],
      "description": "A partial status means AD/CVD is undetermined and this estimate is incomplete. Pass its message to the user; a zero calculated AD/CVD component does not establish zero liability."
    },
    "adcvd_supplier": {
      "type": [
        "object",
        "null"
      ],
      "description": "Supplier deposit evidence when supplied by the calculation: reviewed entry date, matched legal identities, rules, effective windows, official sources, and cases actually included. A matched case does not establish complete all-orders coverage."
    },
    "policy_notices": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Source-backed scope and supplier notices affecting use of this estimate."
    },
    "government_fees": {
      "type": [
        "object",
        "null"
      ],
      "description": "MPF and HMF, the fees CBP actually collects."
    },
    "service_fees": {
      "type": [
        "object",
        "null"
      ],
      "description": "Filing and handling charges such as ISF. Not government fees; CBP charges nothing to receive an Importer Security Filing."
    },
    "total_import_cost_usd": {
      "type": [
        "number",
        "null"
      ],
      "description": "Calculated duties plus government and service fees, excluding merchandise and freight. Provisional when estimate_status is partial."
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "source": {
      "type": "string"
    },
    "disclaimer": {
      "type": "string",
      "description": "Planning estimate, not a customs ruling. Pass this on to the user."
    },
    "needs_classification": {
      "type": "boolean",
      "description": "True when a product description was given instead of a code. Nothing was priced and nothing was charged; show the candidates and ask the user to confirm."
    },
    "candidates": {
      "type": "array",
      "description": "Candidate HTS lines to confirm, present only when needs_classification is true.",
      "items": {
        "type": "object"
      }
    },
    "message": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "gateway": {
      "type": "string",
      "description": "Guest tier only."
    },
    "guest_lookups_remaining": {
      "type": "number",
      "description": "Guest tier only."
    }
  }
}

Find the US Harmonized Tariff Schedule classification for a product. Returns candidate HTS codes with their official descriptions and base duty rates. Use when the user wants the code itself rather than a cost.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Product description, e.g. \"cotton t-shirts\" or \"lithium ion batteries\"."
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "results": {
      "type": "array",
      "description": "Candidates ranked by text match, not a classification ruling.",
      "items": {
        "type": "object",
        "properties": {
          "hts_code": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "base_duty_rate": {
            "type": [
              "string",
              "null"
            ]
          },
          "priceable": {
            "type": "boolean",
            "description": "False for 4 and 6 digit headings, which carry no rate and cannot be priced."
          }
        }
      }
    },
    "warning": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "disclaimer": {
      "type": "string"
    },
    "gateway": {
      "type": "string"
    },
    "guest_lookups_remaining": {
      "type": "number"
    }
  }
}

List US trade policy changes Gateway has published since a given date: new tariff actions, rate changes, effective dates and expirations. Use to answer "what changed recently" or "what is coming".

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "description": "ISO date, e.g. \"2026-07-01\". Filters on when Gateway PUBLISHED the change. Defaults to 30 days ago."
    },
    "limit": {
      "type": "number",
      "description": "Max entries to return, default 20, max 50."
    }
  }
}

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "description": "The date filtered on, ISO."
    },
    "count": {
      "type": "number"
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "what_changed": {
            "type": "string"
          },
          "policy_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": [
              "string",
              "null"
            ]
          },
          "impact": {
            "type": [
              "string",
              "null"
            ]
          },
          "countries": {
            "type": [
              "string",
              "array",
              "null"
            ]
          },
          "effective": {
            "type": [
              "string",
              "null"
            ],
            "description": "Free text as published, e.g. \"In effect for goods entered on or after...\". Not a date and not parseable as one."
          },
          "published": {
            "type": [
              "string",
              "null"
            ],
            "description": "When Gateway published the entry. This is what `since` filters on."
          }
        }
      }
    },
    "source": {
      "type": "string"
    },
    "disclaimer": {
      "type": "string"
    },
    "gateway": {
      "type": "string"
    },
    "guest_lookups_remaining": {
      "type": "number"
    }
  }
}