v2

latestOpenAPI 3.0.42026-08-084694591.6 MB
Item

Find items based on search parameters.

post/api/items/list/v2

Query parameters

Sort.Fieldstring

Sort field

Sort.Dir'ascending' | 'descending'

Specify sorting direction.

Sort direction

Skipinteger

Number of records to skip.

Takeinteger

Number of records to return (maximum)

Request body

latestRevisionboolean

Indicate whether we want the latest revision(s) of the items.

itemIdsstring[] nullable

Filter to items whose ids are in the list

descriptionFilterstring nullable

Filter items by description. Use (escaped) double-quotes to filter by exact phrase, e.g., \"search phrase\". Prepend search term with "-" to exclude

isArchivedboolean nullable

Include or exclude archived items

includeUsageDataboolean

If set to true, data on where the item is being used will be included in the results

includeVendorDataboolean

If set to true, vendor details about the item will be included in the results

includeCustomerDataboolean

If set to true, customer details about the item will be included in the results

includeCustomerTierDataboolean

If set to true, customer tier details about the item will be included in the results

vendorIdstring nullable

If provided, filter to items that are produced by this vendor.

Response

List of items matching the filters

idstring required

Id

numberstring required

The number to give the item.

descriptionstring required

The description to give the item.

itemOrigin'make' | 'buy' | 'makeOrBuy' | 'customerSupplied' | 'kit' | 'none' required
unitTypeNamestring required

The unit of measure type, ex: Piece, Volume or Weight

unitOfMeasureNamestring required

The unit of measure name. Options available depend on the selected UnitTypeName. For Pieces, you might have a UOM of Piece, Set or Case. For Volume, options include Liter, Milliliter, etc.

barCodeNumberstring nullable

The barcode number to give the item.

isSellableboolean

Define if this item is able to be sold/sellable.

isArchivedboolean

Indicate if this item is archived.

isNonInventoryboolean

Indicate if this item is considered a non-inventory item.

accountingCodeIdstring nullable

Accounting code key identifier. Please reference /api/accounting-codes endpoint.

accountingCode2Idstring nullable

Accounting code 2 key identifier. Please reference /api/accounting-codes endpoint.

materialCodeIdstring nullable

Item material code key identifier. Please reference /api/material-codes endpoint.

gradeIdstring nullable

Item grade code key identifier. Please reference /api/grade-codes endpoint.

shapeIdstring nullable

Item shape code key identifier. Please reference /api/shape-codes endpoint.

gaugeIdstring nullable

Item gauge code key identifier. Please reference /api/gauge-codes endpoint.

categoryIdstring nullable

Item category code key identifier. Please reference /api/item-categories endpoint.

widthnumber double nullable

Item width

heightnumber double nullable

Item height

lengthnumber double nullable

Item length

weightnumber double nullable

Item weight

materialWeightnumber double nullable

The weight of material item (calculated)

minimumStockOnHandnumber double nullable

Item minimum stock on hand.

minimumProductionQuantitynumber double nullable

Item minimum production quantity for a manufacturing run.

customFieldsobject nullable

Custom fields that have been defined on this entity.

internalNotesstring nullable

Internal item notes.

externalReferencesobject nullable

External references associated with this entity.

isTaxableboolean nullable

Whether this item is taxable

buildToOrderboolean nullable

Whether or not this item is build to order (jobs are made from sales orders, not overall demand)

buildToStockboolean nullable

Whether or not this item is build to stock (jobs are created from overall demand, not sales orders)

isSingleUseItemboolean nullable

Indicate if this item is intended for single use.

isLotTrackedboolean nullable

Indicate if this item is lot-tracked.

createdUtcstring date-time

The date the item was created

modifiedUtcstring date-time

The date the item was last modified

qualityPlanStatus'needsApproval' | 'approved'