---
search:
  tags:
    - Medicines
    - GET
seo:
  description: >-
    Any signed in user. Returns a page of the stock ledger for one… Reference
    for the GET /api/v1/medicines/{medicineId}/movements endpoint in the
    PharmaFlow API.
sidebar:
  label: List a medicine's stock movements
  badge: GET
title: List a medicine's stock movements
type: openapi-operation
---
Any signed in user. Returns a page of the stock ledger for one medicine, newest first. The ledger is the only record, so an unknown medicine reports no movements, not an error.

`GET /api/v1/medicines/{medicineId}/movements`

**Responses**

- `200` — A page of stock movements
- `401` — Not authenticated

Response example, 200:

```json
{
  "total": -9007199254740991,
  "page": -9007199254740991,
  "page_size": -9007199254740991,
  "items": [
    {
      "id": "string",
      "medicine_id": "string",
      "branch_id": "string",
      "batch_id": "string",
      "qty_delta": -9007199254740991,
      "movement_type": "string",
      "reference_id": "string",
      "reference_type": "string",
      "reason": "string",
      "created_by": "string",
      "client_mutation_id": "string",
      "device_id": "string",
      "created_at": "string",
      "user_name": "string"
    }
  ]
}
```