Calculate Tariff

POST/v1/tariffs/calculate$0.05 per call

Calculate total U.S. import duty and landed cost for a single shipment. Stacks all applicable duty layers.

Send an Idempotency-Key header to retry safely.

Request body

Field	Type	Description
htsCoderequired	string	10-digit HTS code
countryOfOriginrequired	string	ISO-2 country code
declaredValuerequired	number	Declared value in USD
entryDaterequired	string	Entry date (YYYY-MM-DD), defaults to today Required: which tariff authorities apply, and the fee limits, depend on the entry date. format date
dateOfLoadingoptional	string	format date
modeOfTransportoptional	string	Affects HMF calculation (ocean only) one of "OCEAN", "AIR", "GROUND"
quantityoptional	number
quantityUnitoptional	string
steelContentPctoptional	number	Steel content percentage for Section 232
aluminumContentPctoptional	number	Aluminum content percentage for Section 232
ftaClaimoptional	string	FTA SPI indicator (e.g. S for USMCA)

Response fields

Field	Type	Description
success	boolean	e.g. `true`
data	object
data.id	string	e.g. `tcalc_8f6f8d57bd631364`
data.htsCode	string	e.g. `6403.99.60.00`
data.htsDescription	string	e.g. `For men, youths and boys`
data.countryOfOrigin	string	e.g. `VN`
data.countryName	string	e.g. `Vietnam`
data.declaredValue	number	e.g. `10000`
data.entryDate	string	e.g. `2026-11-04`
data.duties	object
data.duties.baseDuty	object
data.duties.section301	null
data.duties.section232	null
data.duties.section122	null
data.duties.ieepa	null
data.duties.section301ForcedLabor	object
data.duties.section301Brazil	null
data.duties.section338Canada	null
data.duties.adCvd	object
data.fees	object
data.fees.mpf	object
data.fees.hmf	null
data.summary	object
data.summary.totalDutyAmount	number	e.g. `2100`
data.summary.totalFeesAmount	number	e.g. `34.64`
data.summary.totalLandedCost	number	e.g. `12134.64`
data.summary.effectiveDutyRate	string	e.g. `21.0%`
data.summary.effectiveTotalRate	string	e.g. `21.35%`
data.summary.breakdown	array
data.ftaOpportunities	array
data.warnings	array
data.meta	object
data.meta.calculatedAt	string	e.g. `2026-11-04T09:01:10.762Z`
data.meta.dataVersion	string	e.g. `2026-HTS`
data.meta.disclaimer	string	e.g. `For informational purposes only. Final duty determination is …`
meta	object
meta.requestId	string	e.g. `tcalc_8f6f8d57bd631364`
meta.timestamp	string	e.g. `2026-11-04T09:01:10.762Z`
meta.processingTimeMs	number	e.g. `310`
meta.dataSource	object
meta.dataSource.name	string	e.g. `ComplianceGrid`
meta.dataSource.provenance	string	e.g. `computed`

Fields are read from a real response captured 2026-11-04, shortened. Optional fields may be absent in other responses.

Errors

400 invalid request
401 missing or bad key
403 not in your plan
429 rate limited, see Retry-After
402 payment required
5xx retry with backoff

Error bodies and codes are described in Error codes and troubleshooting.

curl -X POST "https://api.compliancegrid.ai/v1/tariffs/calculate" \
  -H "Authorization: Bearer $CG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "htsCode": "6403.99.60.00",
    "countryOfOrigin": "VN",
    "declaredValue": 10000,
    "entryDate": "2026-11-04"
  }'

Try it in the sandbox

Runs against sandbox.api.compliancegrid.ai with your own sandbox key, which stays in this browser. Sandbox responses are mock data. Get a free key.

Sandbox key

Remember for this tab

Request body (JSON)

Example response · captured from production 2026-11-04 · shortened

{
  "success": true,
  "data": {
    "id": "tcalc_8f6f8d57bd631364",
    "htsCode": "6403.99.60.00",
    "htsDescription": "For men, youths and boys",
    "countryOfOrigin": "VN",
    "countryName": "Vietnam",
    "declaredValue": 10000,
    "entryDate": "2026-11-04",
    "duties": {
      "baseDuty": {
        "rate": "8.5%",
        "rateType": "AD_VALOREM",
        "amount": 850,
        "authority": "HTS General Rate (Column 1)",
        "htsProvision": "6403.99.60.00"
      },
      "section301": null,
      "section232": null,
      "section122": null,
      "ieepa": null,
      "section301ForcedLabor": {
        "rate": "12.5%",
        "rateType": "AD_VALOREM",
        "amount": 1250,
        "authority": "USTR Section 301 forced-labor investigations (U.S. note 52)",
        "htsProvision": "9903.05.84",
        "proclamationRef": "91 FR 47318 (28 Jul 2026)",
        "effectiveDate": "2026-07-24"
      },
      "section301Brazil": null,
      "section338Canada": null,
      "adCvd": {
        "flag": false,
        "warning": "",
        "potentialOrders": []
      }
    },
    "fees": {
      "mpf": {
        "rate": "0.3464%",
        "amount": 34.64,
        "min": 34.58,
        "max": 670.86,
        "description": "Merchandise Processing Fee (MPF), fiscal year 2027 limits"
      },
      "hmf": null
    },
    "summary": {
      "totalDutyAmount": 2100,
      "totalFeesAmount": 34.64,
      "totalLandedCost": 12134.64,
      "effectiveDutyRate": "21.0%",
      "effectiveTotalRate": "21.35%",
      "breakdown": [
        {
          "label": "Declared Value",
          "amount": 10000
        },
        {
          "label": "Base Duty (8.5%)",
          "amount": 850
        }
      ]
    },
    "ftaOpportunities": [],
    "warnings": [
      "On 20 Feb 2026 the Supreme Court held (Learning Resources v. Trump) that IEEPA does not authorize tariffs; IEEPA tariffs are not applied to entries on or after this date.",
      "Section 122 surcharges are limited to 150 days; the 2026 surcharge expired on 24 Jul 2026 and is not applied to entries on or after that date."
    ],
    "meta": {
      "calculatedAt": "2026-11-04T09:01:10.762Z",
      "dataVersion": "2026-HTS",
      "disclaimer": "For informational purposes only. Final duty determination is made by U.S. Customs and Border Protection. Consult a licensed customs broker for binding determinations."
    }
  },
  "meta": {
    "requestId": "tcalc_8f6f8d57bd631364",
    "timestamp": "2026-11-04T09:01:10.762Z",
    "processingTimeMs": 310,
    "dataSource": {
      "name": "ComplianceGrid",
      "provenance": "computed"
    }
  }
}