1. Items
  2. Models

Items

Models

Item Model

The item model represents a unique item for which you would like to track the quantity.


object "item"
The enum value identifying this as an item model.

attributes Array.<string>
A list of enumerated strings to give more context to special items. For example: alcohol, marijuana, pharma, dry_ice, lithium

color string
Any value can be added here

created_at integer
Time in epoch seconds when this resource was created

description string
The details about the item

gtin string
The global identifier for the item, which is consistent across vendors for this item

harmonized_code string
The harmonized system code for the item. This is required if you will be shipping this item internationally.

id string
The unique ID given to this product. This will stay the same even if the SKU or GTIN values are updated.

images Array.<string>
A list of URLs of images that have been added for this item

levels Array.<InventoryLevel>
Information about inventory levels for this item across various locations and layouts

Show Details
InventoryLevel.object level
The enum for this object
InventoryLevel.id string
The ID for the level that starts with lvl_
InventoryLevel.location_id string
The ID of the location in which this inventory level is housed
InventoryLevel.layout_id string
The layout ID within the location where this inventory can be found
InventoryLevel.layout_name string
The name of the layout this item is on. This makes it easier to construct a front-end while showing the location of the item without additional latency for querying. If the layout name gets updated, this value will be updated automatically.
InventoryLevel.verified_qty integer
The amount of on hand inventory.
InventoryLevel.damaged_qty integer
The amount of on hand inventory that is deemed damaged
InventoryLevel.manifested_qty integer
The amount of inventory that is on a manifest that has not been added to inventory yet
InventoryLevel.reserved_qty integer
Inventory that has been reserved by being pulled out of the verified_qty count, usually due to being attributed to a fulfillment
InventoryLevel.stored_qty integer
Number of assets created against the item at the InventoryLevel with the status in_storage
InventoryLevel.operational_qty integer
Number of assets created against the item at the InventoryLevel with the status in_use or on_loan
InventoryLevel.processing_qty integer
Number of assets created against the item at the InventoryLevel with the status being one of the following: in_pipeline, in_transit, in_repair, for_sale
InventoryLevel.decommissioned_qty integer
Number of assets created against the item at the InventoryLevel with the status being one of the following: donated, lost, stolen, disposed, out_of_service, missing, sold

metadata object
These are your metadata key value pairs added to the item

name string
The name of the item

length float
The length of the item in inches

width float The width of the item in inches

height float
The height of the item in inches

weight float
The weight of the item in pounds (lbs)

packaged_length float
The length of the item in inches once packaged for shipping. For example, a mobile phone often ships in a box with some cables and reading materials inside. Packaged length would be the length of the box that the mobile phone is housed in.

packaged_width float
The width of the item in inches when placed in shipping packaging

packaged_height float
The height of the item in inches when placed in shipping packaging

packaged_weight float
The weight of the item in pounds (lbs) when placed in shipping packaging

origin_country string
The country that manufactured this item. This is required if shipping the item internationally

organization_id string
The unique identifier for the organization that owns this item. This will always be your organization ID

size string
The size of the item. This is used for display purposes on a product page. This is common when adding something like a "small" or "large" variation.

sku string
The SKU of the item added by you

upc string
The Universal Product Code of the item

total_verified integer
The total verified inventory count across all levels

total_damaged integer
The total damaged inventory count across all levels

total_manifested integer
The total inventory count that is on a manifest

total_reserved integer
The total inventory count that is reserved

total_stored integer
The total asset inventory marked as in_storage

total_operational integer
The total asset inventory marked as in_use or on_loan

total_processing integer
The total asset inventory marked as in_pipeline, in_transit, in_repair, or for_sale

total_decommissioned integer
The total asset inventory marked as donated, lost, stolen, disposed, out_of_service, missing, or sold

updated_at integer
Time in epoch seconds when this resource was updated

value integer
The value of each individual item in cents

last_audited_at date
Timestamp of the last audit date for this item's inventory.

is_asset boolean
Indicates whether the item is an asset.

ship_ready boolean
Indicates whether the item is ready to ship directly.

tariff_codes array
Array of country specific tariff codes. Each entry in the array contains the country and code keys, representing the country and the tariff code respectively.