WOwove
Tariffs

Batch look up duty rates for multiple HS codes, origins, destinations, or entry dates

Look up import duty rates for a batch of items in a single request.

Each item is a self-contained query carrying its own hsCode, originCountry, destinationCountry, and (optionally) entryDate, so callers can mix and match any combination of dimensions in a single request.

Behaviour:

  • Items are processed independently; a failure on one item does not abort the batch.
  • Results are returned in request order and matched to each item by the caller-provided id.
  • Each item counts toward OAuth rate limits as one request.

Limits:

  • Maximum 100 items per request.
  • Item id values must be unique within a request.

For per-item parameter semantics (HS code format, country codes, FTA programs, component values, exclusion codes, etc.) see POST /api/v1/external/tariffs/lookup.

post/api/v1/external/tariffs/batch-lookup

Request

Request body

Example request

{
  "items": [
    {
      "id": "q1",
      "hsCode": "8471609050",
      "originCountry": "CN",
      "destinationCountry": "US",
      "customsValue": 10000,
      "currency": "USD",
      "entryDate": "2024-01-15",
      "componentValues": {
        "aluminum": 30
      },
      "exclusionCodes": [
        "9903.01.21"
      ],
      "applyFtaProgram": "US_AU_FTA"
    }
  ]
}

Response

Batch lookup processed. Per-item status is reported via the success flag on each result.

successboolean

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.