---
title: "Get inventory health metrics"
method: GET
path: "/Metrics/inventory-health"
tags: ["Metrics"]
---

# Get inventory health metrics

`GET /Metrics/inventory-health`

## Request

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

## Response `200`

OK

- BusinessMetricsResponseDtoOfInventoryHealthDto
  - `success` boolean
  - `data` InventoryHealthDto
    - `stockLevelPercent` union: Share of items WITH a reorder point that are at or above it. Null when no item has a reorder point configured, since there is then nothing to judge stock level against.
      - number, double
      - string, double
    - `itemsTracked` union: Items counted in decimal? InventoryHealthDto.StockLevelPercent.
      - integer
      - string, int32
    - `targetPercent` union: No target stock level is stored anywhere in the product; always null.
      - number, double
      - string, double
    - `itemsBelowReorder` union
      - integer
      - string, int32
    - `itemsExpiringSoon` union
      - integer
      - string, int32
    - `expiringSoonDays` union
      - integer
      - string, int32
  - `error` string, nullable
  - `message` string, nullable

## Other responses

- `500`: Internal Server Error

## Changes

- **2026-09-17** `d4ae30be0619`: 6 breaking, 6 info
  - the response property `data/oneOf[#/components/schemas/InventoryHealthDto]/stockLevelPercent` became nullable for the status `200` (media type: text/plain)
  - the response property `data/oneOf[#/components/schemas/InventoryHealthDto]/stockLevelPercent` became nullable for the status `200` (media type: application/json)
  - the response property `data/oneOf[#/components/schemas/InventoryHealthDto]/stockLevelPercent` became nullable for the status `200` (media type: text/json)
  - the response property `data/oneOf[#/components/schemas/InventoryHealthDto]/targetPercent` became nullable for the status `200` (media type: text/plain)
  - …8 more

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/Metrics/inventory-health/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)