TariffClassify API

Start an AI HTS classification job. Returns 202 with a session_id immediately; poll the result endpoint until status=COMPLETE. Typical completion: 15–45 seconds depending on description detail. Counts one unit against your monthly cap.

Request body

{
  "product_description": "Men's cotton t-shirt, knitted, short sleeve, 100% cotton",
  "country_of_origin": "VN"
}

Response

HTTP 202 Accepted

{
  "session_id": "3f5e8a30-1234-5678-9abc-def012345678",
  "status": "PENDING",
  "poll_url": "/api/v1/classify/3f5e8a30-1234-5678-9abc-def012345678"
}

Poll for classification status. While the classifier is running, status will be PENDING, CLARIFYING, or PROCESSING. Poll every 2-3 seconds. When status becomes COMPLETE or FAILED, the job is done.

Response

{
  "session_id": "3f5e8a30-1234-5678-9abc-def012345678",
  "status": "COMPLETE",
  "country_of_origin": "VN",
  "created_at": "2026-05-15T18:42:11.000Z",
  "completed_at": "2026-05-15T18:42:38.000Z",
  "result": {
    "hts_code": "6109.10.0012",
    "confidence": 0.94,
    "reasoning": "Knitted cotton t-shirts for men classify under 6109.10 ...",
    "alternatives": [ /* ... */ ],
    "notes": null
  }
}

Look up an HTS code in the 2026 HTSUS. Accepts 2–10 digits with or without dots. Returns the official description, general (MFN) duty rate, units of quantity, and HS chapter/heading/subheading breakdown.

Response

{
  "htsno": "6109.10.0012",
  "description": "Men's or boys' T-shirts, knitted ...",
  "general": "16.5%",
  "special": "Free (AU,BH,CA,CL,CO,IL,JO,KR,MA,MX,OM,P,PA,PE,S,SG)",
  "units": ["doz.", "kg"]
}

Returns Section 301, IEEPA, and AD/CVD duty overlays applicable to the HTS code and country of origin via longest-prefix match (10→8→6→4→2 digit fallback). Country-specific rows override global rows.

Response

{
  "hts": "6109100012",
  "country_of_origin": "CN",
  "duties": [
    {
      "program": "Section 301 List 4A",
      "rateNotes": "7.5% additional ad valorem",
      "additionalRate": 7.5,
      "sourceUrl": "https://ustr.gov/..."
    },
    {
      "program": "IEEPA China",
      "rateNotes": "Reciprocal country tariff",
      "additionalRate": 10.0,
      "sourceUrl": "https://..."
    }
  ]
}

Returns Partner Government Agency (FDA, USDA, EPA, FCC, ATF, DOT) requirements that attach to the HTS code via longest-prefix match. Country-agnostic. Use this to surface regulatory filing requirements alongside customs duty calculations.

Response

{
  "hts": "3304",
  "flags": [
    {
      "agency": "FDA",
      "description": "FDA jurisdiction: beauty and skincare cosmetics. Subject to MoCRA registration.",
      "source_url": "https://www.fda.gov/cosmetics/..."
    }
  ]
}

Returns CBP CROSS binding rulings whose tariff lines share a prefix with the supplied HTS code, sorted by ruling date (newest first). Useful for defending a classification against CF-28 challenges or audits — every ruling links directly to CBP's published ruling text. `limit` defaults to 5, max 20. Always includes a `cross_search_url` deep link for users to explore the full CROSS database.

Response

{
  "hts": "8471300100",
  "rulings": [
    {
      "rulingNumber": "N304566",
      "htsCode": "8471300100",
      "subject": "The tariff classification of a portable laptop computer from China",
      "rulingDate": "2019-06-21",
      "collection": "ny",
      "url": "https://rulings.cbp.gov/ruling/N304566"
    },
    /* ... up to limit ... */
  ],
  "cross_search_url": "https://rulings.cbp.gov/search?term=847130&category=Classification"
}

Compute the full landed cost stack: base customs duty + Section 301 / IEEPA / AD-CVD overlays + MPF (0.3464%, $29.66 floor, $575.35 cap; USMCA exempt) + HMF (0.125%, ocean only). Pass base_duty_rate as a string from /hts/lookup (e.g. "16.5%") to include base duty; omit it to treat as Free.

Request body

{
  "hts_code": "6109100012",
  "country_of_origin": "CN",
  "shipment_value_usd": 50000,
  "base_duty_rate": "16.5%",
  "transport_mode": "ocean",
  "quantity": 1000
}

Response

{
  "hts_code": "6109100012",
  "country_of_origin": "CN",
  "shipment_value_usd": 50000,
  "transport_mode": "ocean",
  "quantity": 1000,
  "base_duty": {
    "rate_string": "16.5%",
    "rate_percent": 16.5,
    "amount_usd": 8250
  },
  "additional_duties": [ /* Section 301, IEEPA, ... */ ],
  "mpf": {
    "rate_percent": 0.3464,
    "floor_usd": 29.66,
    "cap_usd": 575.35,
    "usmca_exempt": false,
    "amount_usd": 173.20
  },
  "hmf": {
    "rate_percent": 0.125,
    "applies": true,
    "amount_usd": 62.50
  },
  "total_duty_usd": 12235.70,
  "landed_cost_usd": 62235.70,
  "per_unit_landed_cost_usd": 62.24,
  "de_minimis": {
    "status": "INELIGIBLE",
    "threshold_usd": 800,
    "reason": "Shipment value exceeds the $800 Section 321 de minimis threshold."
  },
  "pga_flags": []
}