IEEPA Refund API and Estimator

Live

Entry lines in: the refundable IEEPA amount and the CAPE route for each line out.

For each entry line, the IEEPA percentages the duty stack applies on the entry date, the IEEPA duty on the entered value, the refundable amount, and the CAPE route from the liquidation and reconciliation status, quoting CBP. Up to 500 lines per call; a free estimator takes CSV in the browser.

Get a free key Read the docs

At a glance

Status: Live
Endpoints: POST /v1/tariffs/ieepa-refund
Cost: 10 units per line
MCP tools: tariffs_ieepa_refund
Data: Tariffs dataset 1.0.0, built 2026-10-10.

Try it

Choose an endpoint and a sample, change the parameters, and send. Without a key the public demo answers the sample requests (marked demo, not counted against any quota, limited per IP address). With your key, or your account when you are signed in, any values work and the call counts against your plan. A key stays in this page's memory: it is never stored. Get a free key.

Recorded answer of the real API on the current data for this sample (long arrays trimmed).

Response 200POST/v1/tariffs/ieepa-refund

{
  "data": {
    "as_of": "2026-10-10",
    "lines": [
      {
        "line_id": "ABC-1234567-8-1",
        "entry_number": "ABC-1234567-8",
        "hts10": "6112194050",
        "origin": "CN",
        "entry_date": "2025-12-07",
        "entered_value_usd": 48250,
        "engine_status": "COMPUTED",
        "missing_attributes": [],
        "ieepa_pct_of_value": 20,
        "computed_ieepa_duty_usd": 9650,
        "ieepa_lines": [
          {
            "heading": "9903.01.24",
            "rule_id": "IEEPA_CN_FENT_10_2025NOV",
            "rate_text": "+10% ad valorem on the value of the article",
            "amount_pct": 10,
            "amount_formula": "10",
            "share_of_value": 1,
            "valuation_basis": "full customs value",
            "citations": [
              {
                "type": "federal_register",
                "id": "EO 14357, 90 FR 50725",
                "url": "https://www.federalregister.gov/documents/2025/11/07/2025-19825/modifying-duties-addressing-the-synthetic-opioid-supply-chain-in-the-peoples-republic-of-china",
                "quote": "All articles that are subject to the additional ad valorem rate of duty of 20 percent under Executive Order 14195, as amended, shall instead be subject to an additional ad valorem rate of duty of 10 p…"
              },
              {
                "type": "cbp_csms",
                "id": "CSMS #66749380",
                "url": "https://content.govdelivery.com/accounts/USDHSCBP/bulletins/3fa83c4",
                "quote": "Effective November 10, 2025, the ad valorem duty rate for goods that are the products of China and Hong Kong applicable under EO 14195, as amended, has been lowered from 20% to 10%. The following HTSU…"
              },
              "… 3 more"
            ]
          },
          {
            "heading": "9903.01.25",
            "rule_id": "RECIP_BASE_10_W5",
            "rate_text": "+10% ad valorem on the value of the article",
            "amount_pct": 10,
            "amount_formula": "10",
            "share_of_value": 1,
            "valuation_basis": "full customs value",
            "citations": [
              {
                "type": "cbp_csms",
                "id": "CSMS #65829726",
                "url": "https://content.govdelivery.com/accounts/USDHSCBP/bulletins/3ec7b5e",
                "quote": "Goods of China, including Hong Kong and Macau, continue to be subject to the 10% reciprocal tariff under heading 9903.01.25. EXEMPTIONS The following HTSUS classifications apply to products that are e…"
              },
              {
                "type": "usitc_hts",
                "id": "HTSUS 2026HTSRev3, Chapter 99 heading 9903.01.25",
                "url": "https://hts.usitc.gov/reststop/file?release=2026HTSRev3&filename=Chapter%2099",
                "quote": "9903.01.25: Articles the product of any country, except for products described in headings 9903.01.26–9903.01.33, 9903.02.02–9903.02.91, 9903.96.01, and 9903.96.02, and except as provided for in headi…"
              },
              "… 3 more"
            ]
          }
        ],
        "status": "refundable",
        "refundable_usd": 9650,
        "refundable_basis": "computed from the duty stack",
        "refund_route": {
          "route": "cape_phase_1",
          "phase": 1,
          "reason": "Unliquidated entry: CAPE Phase 1.",
          "citations": [
            {
              "type": "CBP web page",
              "id": "IEEPA Duty Refunds (last modified 2026-09-30, fetched 2026-10-10)",
              "url": "https://www.cbp.gov/trade/programs-administration/trade-remedies/ieepa-duty-refunds",
              "local": "inputs/cbp/cbp_ieepa_refunds.txt",
              "quote": "Phase 1: certain unliquidated entries and certain entries within 80 days of liquidation"
            }
          ]
        },
        "interest": {
          "computed": null,
          "note": "CBP refunds IEEPA duties with interest; interest is not computed here.",
          "citation": {
            "type": "CBP web page",
            "id": "IEEPA Duty Refunds (last modified 2026-09-30, fetched 2026-10-10)",
            "url": "https://www.cbp.gov/trade/programs-administration/trade-remedies/ieepa-duty-refunds",
            "local": "inputs/cbp/cbp_ieepa_refunds.txt",
            "quote": "CAPE is designed to consolidate refunds of IEEPA duties including interest"
          }
        },
        "citations": [
          {
            "type": "CBP web page",
            "id": "IEEPA Duty Refunds (last modified 2026-09-30, fetched 2026-10-10)",
            "url": "https://www.cbp.gov/trade/programs-administration/trade-remedies/ieepa-duty-refunds",
            "local": "inputs/cbp/cbp_ieepa_refunds.txt",
            "quote": "Only the IOR or the licensed customs broker who filed the entries can file a CAPE Declaration."
          },
          {
            "type": "Federal Register",
            "id": "EO 14389, Ending Certain Tariff Actions (91 FR 9437)",
            "url": "https://www.federalregister.gov/documents/2026/02/25/2026-03832/ending-certain-tariff-actions",
            "local": "inputs/fr/2026-03832.txt",
            "quote": "shall no longer be in effect and, as soon as practicable, shall no longer be collected"
          },
          "… 1 more"
        ]
      }
    ],
    "summary": {
      "lines": 1,
      "by_status": { "refundable": 1 },
      "refundable_usd_determined": 9650,
      "refundable_usd_range_incl_undetermined": [9650, 9650],
      "interest": "not included"
    },
    "sources": [
      {
        "type": "CBP web page",
        "id": "IEEPA Duty Refunds (last modified 2026-09-30, fetched 2026-10-10)",
        "url": "https://www.cbp.gov/trade/programs-administration/trade-remedies/ieepa-duty-refunds",
        "local": "inputs/cbp/cbp_ieepa_refunds.txt"
      },
      {
        "type": "Federal Register",
        "id": "EO 14389, Ending Certain Tariff Actions (91 FR 9437)",
        "url": "https://www.federalregister.gov/documents/2026/02/25/2026-03832/ending-certain-tariff-actions",
        "local": "inputs/fr/2026-03832.txt",
        "quote": "shall no longer be in effect and, as soon as practicable, shall no longer be collected"
      },
      "… 1 more"
    ],
    "disclaimer": "Reference calculation from the HTS code and facts supplied; not legal advice and not a classification. Only the importer of record or its licensed customs broker can file a CAPE Declaration.",
    "engine": {
      "name": "engine-ts (datasets/tariffs)",
      "rules_version": "1.0.0",
      "coverage": { "from": "2025-01-01", "to": "2026-10-09" },
      "parity": "identical to the Python reference engine on 500 test and 3,000 stress queries (datasets/tariffs/engine-ts/PARITY.md)"
    },
    "method": "Per line: IEEPA duty = entered value x the IEEPA Chapter 99 percentages the duty stack applies on the entry date (rounded to cents); refundable = that amount, or the IEEPA duty actually paid when decl…"
  },
  "meta": {
    "request_id": "req_…",
    "api_version": "1",
    "dataset": "tariffs",
    "dataset_version": "1.0.0",
    "dataset_built_at": "2026-10-10T16:05:28Z",
    "data_status": "released",
    "sources": [
      {
        "id": "usitc_harmonized_tariff_schedule_chapter",
        "name": "USITC Harmonized Tariff Schedule (Chapter 99 PDFs, Change Records, releaseList, exportList REST)",
        "url": "https://hts.usitc.gov/",
        "licence": "U.S. Government work, public domain (17 U.S.C. 105)",
        "commercial_redistribution_ok": true,
        "retrieved": "2026-10-09/2026-10-10"
      },
      {
        "id": "federal_register_proclamations_executive",
        "name": "Federal Register (proclamations, executive orders, USTR/Commerce notices)",
        "url": "https://www.federalregister.gov/",
        "licence": "U.S. Government work, public domain (17 U.S.C. 105)",
        "commercial_redistribution_ok": true,
        "retrieved": "2026-10-09/2026-10-10"
      },
      "… 3 more"
    ],
    "provenance_note": "Every value carries provenance (source, id or URL, retrieval date; method and confidence where an AI judged). Calculations list their inputs and method.",
    "disclaimer": "Reference data and calculations from HTS codes you supply. Not classification advice and not a filing: entry filings need a licensed customs broker (CBP HQ H350722).",
    "usage": "…"
  }
}

1Each line carries its citations, with the quoted text
2Pin and diff: the version is also in the X-Dataset-Version header

curlPOST/v1/tariffs/ieepa-refund

curl -s -X POST "https://api.htscalculator.com/demo/v1/tariffs/ieepa-refund" \
  -H "Content-Type: application/json" \
  -d '{"as_of":"2026-10-10","lines":[{"entry_number":"ABC-1234567-8","line_number":1,"hts10":"6112194050","origin":"CN","entry_date":"2025-12-07","export_date":"2025-11-17","mode":"vessel","entered_value_usd":48250,"liquidation_status":"unliquidated"}]}'

Endpoints

Endpoints of the IEEPA Refund API and Estimator
Endpoint	What it does	Cost	MCP tool	Documentation
POST /v1/tariffs/ieepa-refund	IEEPA refund calculation for entry lines	10 units per line	tariffs_ieepa_refund	Docs

What is included

Refundable amount per line, or the IEEPA duty you paid when you declare it
CAPE route (Phase 1, Phase 2, later, or outside CAPE) with quotes from CBP
Free web estimator: CSV in, CSV out
Interest estimate Coming soon
ACE entry summary line report import Coming soon

How it differs

Each line shows which IEEPA headings applied on its entry date.
The CAPE route quotes the CBP page it rests on.
An estimate for planning; only the importer or its broker files a CAPE Declaration.

Plans

One key and one plan cover every HTS Calculator product, this one included. Free: 2,500 units a month. Developer $49 and Pro $249 a month. Caching inside your product is allowed, and so is use by AI agents. Plans and units.

Status: Live. All products.