DEV

Type.

Item

An Item represents the input for a shopping cart Item to be quoted for Landed Cost, Shipment Rating, etc. Item is not intended to be stored and used long-term for things like the catalog; it is purely a method for moving data around.

Fields

id

•

ID!

Required

Item ID, prefixed with item_.

customsSpecs

•

[CustomsSpec!]!

Required

No description

advertisedDescription

•

String

Advertised or marketing description of the Item, distinct from the customs or internal description.

amount

•

Decimal!

Required

Item price amount.

amountDetails

•

[ItemAmountDetail!]!

Required

Details about the item amounts in different currencies

amountInclusive

•

Decimal

Item price all inclusive amount if inclusive amount is enabled.

attributes

•

[ItemAttribute]

Free-form Item attributes.

catalogItem

•

CatalogItem

Link to an existing CatalogItem that contains more info about this Item.

categories

•

[String!]

List of categories associated and describing the Item

classification

•

Classification

Classification of an Item if ClassifyMissingHsCodesStatus is ENABLED for an organization.

countryOfOrigin

•

CountryCode

Country where the Item originates.

countryOfOriginSource

•

ItemValueSource

Indicates where the CountryOfOrigin was sourced from.

createdAt

•

DateTime!

Required

When this Item was created.

createdBy

•

ID!

Required

The user that created this Item.

currencyCode

•

CurrencyCode!

Required

The currency this Item price amount is in.

customsDescription

•

String

The description of the Item for customs.

description

•

String

Human-readable Item description.

dutyTaxFeeConfiguration

•

DutyTaxFeeConfiguration

Allows user to remove items from duties, taxes, or fee calculations

gtin

•

String

Global Trade Item Number for the Item.

hsCode

•

String

HS code for this Item.

hsCodeSource

•

ItemValueSource

Indicates where the HS code for this Item was acquired.

imageUrl

•

String

Optional URL to an image that represents this Item.

itemType

•

ItemType

Determines whether or not an item can be physically shipped.

manufacturerParty

•

Party

The manufacturer Party of this Item.

manufacturerProductId

•

String

No description

marketplace

•

ItemMarketplace

Marketplace where this Item is sold.

measurements

•

[ItemMeasurement]

List of Item weights and dimensions.

metadata

•

[ItemMetadata]

User-accessible key/value metadata.

mode

•

Mode!

Required

Whether this Item was created in live or test mode.

name

•

String

Human readable item name.

organization

•

ID!

Required

The unique identifier associated with an organization.

packageOptionId

•

ID

Deprecated

The box in a bundle this item is assigned to

packageOptionIdIndex

•

String

Deprecated

Index identifying the specific package option instance within a bundle (e.g. packageOptionId + instance index)

packingConfiguration

•

PackingConfiguration

The stacking configuration associated with this Item

packingPreference

•

PackingPreference

Deprecated

The packing options of the item

parentItemId

•

ID

The id of this Item's parent Item, if this Item is itself a subItem. Null if this Item is not a subItem of another Item.

parentProductId

•

String

Deprecated

The product ID of the parent Item for multi-SKU situations.

productComposition

•

[ItemComposition!]

the composition of your product

productId

•

String!

Required

The Item product ID.

productListingUrl

•

String

URL where the product is listed for sale.

provinceOfOrigin

•

String

Optional administrative area where this Item originates. Required by some countries.

quantity

•

Int!

Required

Quantity of this specific Item being represented.

restriction

•

RestrictedItem

when the item is restricted, this property will have some details as to why.

reverseAmountDetail

•

[ItemReverseAmountDetail!]

reverse amount details for this item

securityScreeningReportNumber

•

String

Security screening report number for this Item.

sku

•

String

SKU of this Item.

subItems

•

[Item!]!

Required

Component sub-items of this Item (e.g. a watch's band, movement, case, battery), one level deep. Empty if this Item has no components.

updatedAt

•

DateTime!

Required

When this Item was most recently updated.

updatedBy

•

ID!

Required

User who most recently updated this Item.

Was this page helpful?


Get support·Legal docs·© 2026 Zonos