--- title: "Get All ERP Inventory Items" method: GET path: "/erp/inventory" tags: ["erp", "Inventory"] --- # Get All ERP Inventory Items `GET /erp/inventory` ## Request - Base URL: `https://production.trackstarhq.com` - URL: `https://production.trackstarhq.com/erp/inventory` - Auth: none required Returns all Inventory Items for the ERP connection associated with the provided access token. ## Query parameters - `page_token` string, nullable - `limit` integer - `ids` ErpInventoryItemIdsQueryParam - `in` string[], required: A comma-separated list of resource IDs. If provided, all other query params are ignored. - `created_date` ErpInventoryItemCreatedDateQueryParam - `eq` string, date-time - `neq` string, date-time - `in` string[]: Comma-separated. - `nin` string[]: Comma-separated. - `gt` string, date-time - `gte` string, date-time - `lt` string, date-time - `lte` string, date-time - `updated_date` ErpInventoryItemUpdatedDateQueryParam - `eq` string, date-time - `neq` string, date-time - `in` string[]: Comma-separated. - `nin` string[]: Comma-separated. - `gt` string, date-time - `gte` string, date-time - `lt` string, date-time - `lte` string, date-time - `trackstar_created_date` ErpInventoryItemTrackstarCreatedDateQueryParam - `eq` string, date-time - `neq` string, date-time - `in` string[]: Comma-separated. - `nin` string[]: Comma-separated. - `gt` string, date-time - `gte` string, date-time - `lt` string, date-time - `lte` string, date-time - `trackstar_updated_date` ErpInventoryItemTrackstarUpdatedDateQueryParam - `eq` string, date-time - `neq` string, date-time - `in` string[]: Comma-separated. - `nin` string[]: Comma-separated. - `gt` string, date-time - `gte` string, date-time - `lt` string, date-time - `lte` string, date-time - `trackstar_tags` ErpInventoryItemTrackstarTagsFlatQueryParam - `contains` string[]: Comma-separated. - `not_contains` string[]: Comma-separated. - `sku` ErpInventoryItemSkuQueryParam - `eq` string - `neq` string - `in` string[]: Comma-separated. - `nin` string[]: Comma-separated. - `contains` string - `not_contains` string - `is_null` boolean: Filter by whether the field is null. - `active` boolean ## Headers - `x-trackstar-api-key` string, required - `x-trackstar-access-token` string, required ## Response `200` Successful response - ErpInventoryListEndpoint - `data` ErpInventoryItemApiItemSchema[], required - `id` string, required: The unique ID of the inventory item in the ERP. - `created_date` string, date-time, required: The date the inventory item was created. - `updated_date` string, date-time, required: The date the inventory item was last updated. - `name` string, required: The display name of the inventory item. - `sku` string, nullable, required: The SKU / item number of the inventory item. - `upc` string, nullable, required: UPC / GTIN barcode for the item. - `active` boolean, required: Whether the inventory item is active. - `description` string, nullable, required: A long-form description of the inventory item. - `unit_cost` number, nullable, required: Cost of a single unit of the inventory item, expressed in the ERP's base currency. The accounting meaning (e.g., standard, average, FIFO/LIFO) depends on `costing_method`. - `costing_method` string, nullable, required: How the ERP values this item for inventory accounting (e.g., Standard, Average, FIFO, LIFO). - `stock_unit` string, nullable, required: Unit of measure for on-hand quantities (e.g., EA, LB, CS). - `onhand` number, nullable, required: Total physical on-hand quantity across all locations. - `committed` number, nullable, required: Total quantity committed / reserved against orders across all locations. - `available` number, nullable, required: Total quantity available to sell across all locations (typically onhand minus committed). - `inventory_by_location_id` object, required: Inventory broken down by location. A location can be a warehouse, retail store, production line, or consignment site depending on how the ERP is configured. - `vendors` ErpItemVendor[], required: Vendors from whom this item is purchased. - `vendor_id` string, required: ID of the vendor in the ERP. - `vendor_name` string, nullable, required: Display name of the vendor. - `lots` ErpLot[], required: A lot is a specific batch of inventory items that are stored together and expire together. If an item doesn't expire, it is not allocated to a lot. - `lot_id` string, required: Lot ID. - `lot_name` string, nullable, required: Human-readable lot name as shown in the source ERP (e.g. 'LOT-20260418-A'). - `onhand` number, required: Quantity on hand for this lot at this location. - `expiration_date` string, date-time, nullable, required: The date that the lot expires. - `location_id` string, required: ID of the location the lot is stored at. Same identifier as in /erp/locations and inventory_by_location_id keys. - `bins` ErpBin[], required: Bins are physical storage slots within a location. For items also tracked by lot, each entry is a (lot, bin) pair — the same bin can appear across multiple entries (holding different lots) and the same lot can appear across multiple bins. - `bin_id` string, required: Bin ID. - `bin_name` string, nullable, required: Human-readable bin name as shown in the source ERP (e.g. 'C-03-L3-P2'). - `onhand` number, required: Quantity on hand in this bin (for the optionally-paired lot, when the item is also lot-tracked). - `location_id` string, required: ID of the location the bin is in. Same identifier as in /erp/locations and inventory_by_location_id keys. - `lot_id` string, nullable, required: If the item is both lot-tracked and bin-tracked, the lot occupying this bin. Null when the item is bin-tracked but not lot-tracked. - `custom_fields` object, required: Per-account custom fields defined on the inventory item. Keys are the field names as defined in the ERP; each value carries the raw value, its declared type, and a human-readable label. - `measurements` InventoryItemMeasurementsErp, required - `length` number, nullable, required - `width` number, nullable, required - `height` number, nullable, required - `unit` 'cm' | 'in', nullable, required: The unit of measurement for the size of the inventory item. - `weight` number, nullable, required - `weight_unit` 'kg' | 'oz' | 'lb', nullable, required: The unit of measurement for the weight of the inventory item. - `external_system_url` string, nullable, required: URL link to the inventory item in the external system (WMS/Freight etc). - `trackstar_tags` unknown[], nullable, required: A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair. - unknown - `additional_fields` object, required: Integration-specific fields - `trackstar_created_date` string, date-time, required - `trackstar_updated_date` string, date-time, required - `next_token` string, nullable, required: See [pagination](/how-to-guides/about-the-api#pagination) for more details. - `total_count` integer, required: The number of items returned. ## Other responses - `422`: Validation error ## Changes - **2026-11-03** `f9f948f2a7b3`: 1 info - endpoint added [Operation history](https://skmtc.dev/trackstarhq/apis/trackstar-api/changes/erp/inventory/get.md) --- [API](https://skmtc.dev/trackstarhq/apis/trackstar-api.md) - [All operations](https://skmtc.dev/trackstarhq/apis/trackstar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trackstarhq/apis/trackstar-api/revisions/08647f790594?raw)