---
search:
  tags:
    - Alerts
    - GET
seo:
  description: >-
    Any signed in user. Returns active medicines at or below their threshold,…
    Reference for the GET /api/v1/alerts/low-stock endpoint in the PharmaFlow
    API.
sidebar:
  label: List low stock alerts
  badge: GET
title: List low stock alerts
type: openapi-operation
---
Any signed in user. Returns active medicines at or below their threshold, thinnest first. Each row carries the shortfall, so the caller orders against the gap, not recomputing it.

`GET /api/v1/alerts/low-stock`

**Responses**

- `200` — Medicines at or below their threshold
- `401` — Not authenticated

Response example, 200:

```json
{
  "alerts": [
    {
      "medicine_id": "string",
      "name": "string",
      "stock_quantity": 0,
      "low_stock_threshold": 0,
      "deficit": 0
    }
  ],
  "count": -9007199254740991
}
```