Classify, calculate, declare.

One call for the whole shipment. Each item comes back with its tariff code, its duty, taxes and fees, and what each government agency that flags it needs.

POST /v1/prepare
3 items to United StatesClassifyCalculateDeclare
Wooden stacking blocks× 2
Ceramic pour-over set
Merino wool scarf

Duty, 3 lines

…

Working

Sample shipment. Fees and taxes are in the full response.

Three steps, one response.

  1. Classify

    Items without an HS code get the destination's tariff code from a title, description, photo or product page. Items that already have one keep it.

  2. Calculate

    Duty, taxes and fees for every line, priced as one shipment, so a de minimis threshold tests the lines together and shipping and insurance are shared by value.

  3. Declare

    For each code, every partner government agency that flags it, such as CPSC, FDA, APHIS and EPA. For CPSC and FDA, whether to file its data or disclaim.

One item failing never fails the shipment.

Every item carries its own issues, so a line that can't be classified or priced doesn't hold up the rest. The shipment is ready only when every item has a code, a price and a settled agency decision.

POST/v1/prepare
Request
POST /v1/prepare
{
  "destination_country": "US",
  "currency": "USD",
  "items": [
    {
      "sku": "TOY-1",
      "title": "Wooden stacking blocks",
      "description": "Painted wooden stacking toy blocks for children aged 1 to 3",
      "country_of_origin": "CN",
      "declared_value": 12.99,
      "quantity": 2
    },
    { "sku": "MUG-1", "hs_code": "6912004810",
      "country_of_origin": "VN", "declared_value": 38 },
    { "sku": "SCARF-1", "hs_code": "6117101000",
      "country_of_origin": "NZ", "declared_value": 45 }
  ]
}
Response, shortened
{
  "ready": false,
  "items": [
    {
      "sku": "TOY-1",
      "hs_code": "9503000071",
      "classification": {
        "source": "classified",
        "confidence": "High"
      },
      "duty": { "totals": { "duty": 3.25 } },
      "declarations": [
        { "agency": "CPS", "requirement": "required" },
        { "agency": "EPA", "requirement": "may_be_required" }
      ],
      "issues": [
        "U.S. Environmental Protection Agency flags this code: file its data, or disclaim"
      ]
    },
    { "sku": "MUG-1", "hs_code": "6912004810",
      "classification": { "source": "provided" },
      "declarations": [
        { "agency": "FDA", "requirement": "required" }
      ] },
    { "sku": "SCARF-1", "hs_code": "6117101000",
      "classification": { "source": "provided" },
      "declarations": [], "issues": [] }
  ],
  "totals": { "duty": 21.67, "items_calculated": 3, "items": 3 }
}

Built for the shipment, not the single line.

Lines priced together

De minimis thresholds test the whole shipment, and shipping and insurance costs are shared across the items by value.

Agency decisions

CPSC and FDA come with a file or disclaim decision. Every other agency that flags a code, such as APHIS or EPA, is listed so you can file or disclaim. How the agency flags work

Issues per item

Each item says what is missing, and the shipment-level ready flag tells you when there's nothing left to fix.

Dated rates

Send an entry date and the call uses the rates in force on that day.

Invoice currency

Declared values, shipping and insurance in the currency on the invoice, defaulting to the destination's currency.

Its own scope

Keys need the prepare:read scope, so you can hand one to a partner without opening the rest of your workspace.

Common questions

Which destinations does it cover?

Classification covers full tariff codes for Austria, Belgium, Bulgaria, Croatia, Cyprus, the Czech Republic, Denmark, Estonia, European Union (customs zone), Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, the Netherlands, Poland, Portugal, Puerto Rico, Romania, Slovakia, Slovenia, Spain, Sweden, the United Kingdom, the United States and U.S. Virgin Islands, plus global 6-digit HS codes. Landed cost is live for Puerto Rico, the United Kingdom, the United States and U.S. Virgin Islands. Agency decisions start with US imports. Other destinations still get codes and landed cost, with declarations set to null.

Do I need HS codes first?

No. Items without a code are classified for the destination. Items that come with one keep it and skip classification, and the response says which is which.

What happens when one item fails?

The request still answers. That item's issues say what is missing, the other items come back in full, and ready stays false until every item is classified, priced and has a settled agency decision.

How many items can one call take?

Up to 50. Each classification and each priced line counts toward usage the same way a classify or calculate call does.

What does an API key need?

The prepare:read scope. You can also limit the agency check to the agencies you file with, by ACE code or by name.

Prepare your next shipment on Traddal.

Tell us your lanes, carriers and volumes. We'll set up a workspace for your team.