Bulk Calculate

POST/v1/tariffs/calculate/bulk$0.05 per call

Calculate tariffs for up to 100 items in a single request.

Send an Idempotency-Key header to retry safely.

Request body

Field	Type	Description
itemsrequired	array of object	max 100 items
items[].htsCoderequired	string	10-digit HTS code
items[].countryOfOriginrequired	string	ISO-2 country code
items[].declaredValuerequired	number	Declared value in USD
items[].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
items[].dateOfLoadingoptional	string	format date
items[].modeOfTransportoptional	string	Affects HMF calculation (ocean only) one of "OCEAN", "AIR", "GROUND"
items[].quantityoptional	number
items[].quantityUnitoptional	string
items[].steelContentPctoptional	number	Steel content percentage for Section 232
items[].aluminumContentPctoptional	number	Aluminum content percentage for Section 232
items[].ftaClaimoptional	string	FTA SPI indicator (e.g. S for USMCA)

Response fields

Field	Type	Description
success	boolean	e.g. `true`
data	object
data.totalItems	number	e.g. `1`
data.results	array
data.results[].id	string	e.g. `tcalc_0fd7c06677f42c7a`
data.results[].htsCode	string	e.g. `6403.99.60.00`
data.results[].htsDescription	string	e.g. `For men, youths and boys`
data.results[].countryOfOrigin	string	e.g. `VN`
data.results[].countryName	string	e.g. `Vietnam`
data.results[].declaredValue	number	e.g. `10000`
data.results[].entryDate	string	e.g. `2026-11-04`
data.results[].duties	object
data.results[].fees	object
data.results[].summary	object
data.results[].ftaOpportunities	array
data.results[].warnings	array
data.results[].meta	object
meta	object
meta.timestamp	string	e.g. `2026-11-04T09:01:11.396Z`
meta.processingTimeMs	number	e.g. `37`
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/bulk" \
  -H "Authorization: Bearer $CG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "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": {
    "totalItems": 1,
    "results": [
      {
        "id": "tcalc_0fd7c06677f42c7a",
        "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": [
            "…",
            "…"
          ]
        },
        "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:11.396Z",
          "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": {
    "timestamp": "2026-11-04T09:01:11.396Z",
    "processingTimeMs": 37,
    "dataSource": {
      "name": "ComplianceGrid",
      "provenance": "computed"
    }
  }
}