Tariff Calculator
Smart Calculate (AI)
POST
/v1/tariffs/calculate/smart$0.05 per callAI-enhanced tariff calculation with plain-English compliance advisory, risk factors, and sourcing insights.
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
The spec does not describe this response yet, and there is no captured example. Run the request with your sandbox key to see its shape.
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.