List items

GET 
/items

Returns a paginated list of items across all types — raw materials, ingredients, packaging, and more. Each item includes pricing, shelf life, allergens, storage requirements, and custom fields. Use the filters to narrow by type, category, perishability, or allergen content.

Request

Response

200

Paginated list of items

400

Bad request — invalid parameters

401

Unauthorized — missing or invalid API key

Response

{
  "data": [
    {
      "id": "2087",
      "inventoryCode": "INV-000312",
      "name": "Organic Tahini",
      "itemType": "raw_material",
      "category": "Pastes",
      "defaultUnit": "lbs",
      "unitPrice": 3.25,
      "recommendedRetailPrice": null,
      "minimumOrderQuantity": 100,
      "perishable": true,
      "storageRequirement": "Refrigerate below 40°F",
      "shelfLifeDays": 180,
      "allergens": [],
      "tags": [],
      "itemKinds": [],
      "clientProductId": null,
      "customFields": {},
      "status": "active"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "total": 87
  }
}