DEV

Input.

CustomsDescriptionValidationInput

Item information to validate for classification readiness. Provide either the ID of an existing Item, or the item fields directly (at least one descriptive field). Mirrors the fields the classification services consume.

Fields

amount

•

Decimal

Item price amount, if known. Lets readiness settle tariff lines that depend on value. Amounts in other currencies are converted to USD.

categories

•

[String!]

List of categories associated and describing the item.

currencyCode

•

CurrencyCode

Currency of amount.

description

•

String

Human-readable description of the item.

existingItemId

•

ID

ID of an existing Item to validate. When provided, the stored item's fields are used and any fields supplied here override the stored values.

material

•

String

Material or composition of the item, if known (e.g. "55% cotton, 45% polyester").

name

•

String

Name of the item.

sessionId

•

ID

Session returned by an earlier validation of the same item. Omit to start a new session; return this ID with the complete, updated item information on subsequent calls. Sessions belong to the calling organization and use one destination country. A changed destination starts a new session.

shipToCountry

•

CountryCode

Destination country. When provided, readiness also considers whether the text is enough to pick a country-specific tariff line, not just the 6-digit subheading (enables the READY_TO_SUBHEADING status). When omitted, only subheading-level (6-digit) readiness is checked.

Was this page helpful?


Get support·Legal docs·© 2026 Zonos