> ## Documentation Index
> Fetch the complete documentation index at: https://traddal.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Calculate duties on a consignment

> Run a duty and tax assessment over a consignment's items.

Requires the `consignments:write` scope. Runs a landed-cost assessment over
every item on the consignment using its declared (or classified) HS codes,
origins, and values. The result is stored as an assessment and emits a
`duties.calculated` [webhook](/webhooks/events).

<ParamField path="id" type="string" required>
  The consignment ID.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "assessment_id": "asmt_01J9ZK...",
    "destination_country": "US",
    "total_duty": 12.42,
    "total_tax": 0,
    "currency": "USD",
    "items": [
      {
        "hs_code": "4202.92",
        "duty": 12.42,
        "rates_applied": ["general", "sec301"]
      }
    ]
  }
  ```
</ResponseExample>

Retrieve past assessments with
`GET /consignments/{id}/assessments` and
`GET /consignments/{id}/assessments/{assessment_id}`.