---
search:
  tags:
    - Medicines
    - GET
seo:
  description: >-
    Any signed in user. Returns a page of the catalogue with a live stock
    quantity on… Reference for the GET /api/v1/medicines endpoint in the
    PharmaFlow API.
sidebar:
  label: List the medicine catalogue
  badge: GET
title: List the medicine catalogue
type: openapi-operation
---
Any signed in user. Returns a page of the catalogue with a live stock quantity on every row. Search, category, and form narrow the rows, and low_stock keeps rows at or below threshold.

`GET /api/v1/medicines`

**Responses**

- `200` — A page of medicines
- `401` — Not authenticated

Response example, 200:

```json
{
  "total": -9007199254740991,
  "page": -9007199254740991,
  "page_size": -9007199254740991,
  "items": [
    {
      "id": "string",
      "name": "string",
      "generic_name": "string",
      "barcode": "string",
      "category": "string",
      "form": "string",
      "strength": "string",
      "unit": "string",
      "selling_price": "string",
      "max_public_price": "string",
      "stock_quantity": -9007199254740991,
      "low_stock_threshold": -9007199254740991,
      "requires_prescription": true,
      "is_controlled": true,
      "vat_category": "string",
      "requires_cold_chain": true,
      "sfda_registration_no": "string",
      "image_key": "string",
      "image_url": "string",
      "is_active": true,
      "created_at": "string",
      "updated_at": "string"
    }
  ]
}
```