---
title: "Get stock summary for all inventory items"
method: GET
path: "/Inventory/stock-summary"
tags: ["Inventory"]
---

# Get stock summary for all inventory items

`GET /Inventory/stock-summary`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/Inventory/stock-summary`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/Inventory/stock-summary/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

List of items with aggregated stock information

- InventoryItemDto[]
  - `id` string
  - `name` string
  - `invoiceName` string, nullable
  - `sku` string, nullable
  - `barcode` string, nullable
  - `description` string, nullable
  - `defaultSig` string, nullable: Default prescription instructions (SIG) for rx-required items. See PAW-671.
  - `compoundFormula` string, nullable: Compounding formula / preparation details for compounded items. See PAW-671.
  - `category` string
  - `vaccineTypeId` string, nullable
  - `status` string
  - `vendorId` string, nullable
  - `vendor` VendorSummaryDto
    - `id` string
    - `name` string
    - `code` string, nullable
  - `vendorItemNumber` string, nullable
  - `drugForm` string, nullable
  - `unitOfMeasure` string, nullable: Per-item dispensing-unit label override (e.g. "dose", "applicator"). Null = derive the label from DrugForm (ITE-390).
  - `strength` string, nullable
  - `ndc` string, nullable
  - `isCompounded` boolean
  - `rxRequired` boolean
  - `allowedSpeciesIds` string[], nullable
  - `vcprRequiredDays` union
    - integer
    - string, int32
  - `maxDispenseQuantity` union
    - number, double
    - string, double
  - `weightBandMin` union: Patient weight range the item is for, as entered (ITE-1271). See `InventoryItem.WeightBandMin`.
    - number, double
    - string, double
  - `weightBandMax` union
    - number, double
    - string, double
  - `weightBandUnit` string, nullable: Weight unit code the bounds are in: kg, g, lb, oz.
  - `weightBandMinKg` union: The bounds in kilograms, server-converted, for comparing with a weight reading's canonical value.
    - number, double
    - string, double
  - `weightBandMaxKg` union
    - number, double
    - string, double
  - `deaBookId` string, nullable
  - `deaBook` DEABookSummaryDto
    - `id` string
    - `drugName` string
    - `deaSchedule` string, nullable
  - `deaSchedule` string, nullable
  - `controlledSubstanceSchedule` union
    - integer
    - string, int32
  - `requiresWitness` boolean: Server-computed: does dispensing this item require a witness on submit? Mirrors the predicate in DispenseValidator so UI gating stays in lockstep with backend validation.
  - `distributionCategory` string, nullable
  - `cascadeEligible` boolean
  - `isAntimicrobial` boolean
  - `antimicrobialType` string, nullable
  - `requiresUnderCare` boolean
  - `requiresPhysicalExam` boolean
  - `foodProducing` boolean
  - `requiresWithdrawalPeriod` boolean
  - `unitCost` union
    - number, double
    - string, double
  - `unitPrice` union
    - number, double
    - string, double
  - `pricePolicy` string
  - `isFlatRate` boolean: Bills `unitPrice` once per administration, whatever amount is given.
  - `markupPercent` union
    - number, double
    - string, double
  - `mapPrice` union
    - number, double
    - string, double
  - `dispenseFee` union
    - number, double
    - string, double
  - `unitsPerContainer` union: Dispensing units per container (e.g. 30 tablets per bottle). Display and conversion aid only — never enters price math.
    - number, double
    - string, double
  - `sellingPrice` union: Indicative per-unit selling price derived from the price policy and the most-recent lot cost (or catalog UnitCost). Lets the item-lookup dropdown show a real price instead of $0 for cost-based or empty-UnitPrice items. The amount actually charged is recomputed at dispense from the specific lot, so treat this as an estimate. Null when no price can be inferred.
    - number, double
    - string, double
  - `isTaxable` boolean
  - `vatCategory` string, nullable
  - `trackLots` boolean
  - `storageRequirements` union
    - integer
    - string, int32
  - `minQuantity` union
    - number, double
    - string, double
  - `parQuantity` union
    - number, double
    - string, double
  - `maxQuantity` union
    - number, double
    - string, double
  - `reorderPoint` union
    - number, double
    - string, double
  - `totalOnHand` union
    - number, double
    - string, double
  - `activeLotCount` union
    - integer
    - string, int32
  - `earliestExpiration` string, date-time, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Changes

- **2026-10-28** `099cf36186e0`: 15 info
  - added the optional property `items/weightBandMax` to the response with the `200` status (media type: text/plain)
  - added the optional property `items/weightBandMax` to the response with the `200` status (media type: application/json)
  - added the optional property `items/weightBandMax` to the response with the `200` status (media type: text/json)
  - added the optional property `items/weightBandMaxKg` to the response with the `200` status (media type: text/plain)
  - …11 more
- **2026-10-11** `f7ab358172d0`: 3 info
  - added the optional property `items/isFlatRate` to the response with the `200` status (media type: text/plain)
  - added the optional property `items/isFlatRate` to the response with the `200` status (media type: application/json)
  - added the optional property `items/isFlatRate` to the response with the `200` status (media type: text/json)
- **2026-08-19** `d8d7501dde48`: 3 info
  - added the optional property `items/unitOfMeasure` to the response with the `200` status (media type: text/plain)
  - added the optional property `items/unitOfMeasure` to the response with the `200` status (media type: application/json)
  - added the optional property `items/unitOfMeasure` to the response with the `200` status (media type: text/json)

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/Inventory/stock-summary/get.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)
