## List the stock movements of an article (tenant:stock:read)

`GET /api/trade/v1/stock/{articleId}/movements`

Module: Trade · operationId: `listStockMovements` · Tag: Stock · Auth: access token (`Authorization: Bearer <accessToken>`)

The append-only movement history of the article, newest first.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `limit` | query | integer |  | Page size; at most 500. (default `50`; max 500) |
| `cursor` | query | string |  | The `nextCursor` of the previous page; omit for the first page. A cursor of another list is `400 invalid`. |
| `articleId` | path | string | yes | Masterdata product id of the article. |

### Responses

- **200** A page of movements, newest first (creation time, then id), and the number of all of them (`application/json`)
- **400** Error (`application/json`)
- **401** No valid session or bearer token (no body).
- **403** Missing permission, no active tenant in the token, or a missing CSRF token on a cookie write. (`application/json`)

Fields of the 200 answer:

- `items` (array of StockMovement, required)
  - `actor` (object): Who booked the movement.
    - `kind` (string): `user`, `service`, `system`, `workflow` or `public`.
    - `name` (string): Display name of the actor.
    - `ref` (string): The lower-case e-mail of a person, the instance id of a workflow.
  - `articleId` (string): Masterdata article.
  - `createdAt` (string (date-time)): When the movement was booked.
  - `id` (string (uuid)): Id of the movement.
  - `kind` (string): `return`: goods a customer returned with a credit note, booked back in when it is issued. (one of `goods_receipt`, `delivery`, `correction`, `count`, `reversal`, `return`)
  - `quantity` (number): Signed: receipts positive, deliveries negative.
  - `reason` (string): Reason of a correction or count.
  - `serials` (array of string): Serial numbers moved.
  - `sourceNumber` (string): Number of the source document.
  - `sourceTransactionId` (string (uuid)): The document the movement comes from (not for corrections and counts).
  - `warehouseId` (string): Warehouse of the movement.
- `total` (integer, required)
- `nextCursor` (string): Pass as `cursor` for the next page; absent on the last one.

Example 200 answer:

```json
{
  "items": [
    {
      "actor": {
        "kind": "user",
        "name": "David Richter",
        "ref": "david.richter@muster-it.example"
      },
      "articleId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7c03",
      "createdAt": "2026-11-18T14:20:00Z",
      "id": "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d03",
      "kind": "correction",
      "quantity": -2,
      "reason": "Bruch im Lager",
      "serials": [],
      "warehouseId": "HAUPT"
    },
    {
      "actor": {
        "kind": "user",
        "name": "David Richter",
        "ref": "david.richter@muster-it.example"
      },
      "articleId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7c03",
      "createdAt": "2026-11-17T07:45:00Z",
      "id": "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d02",
      "kind": "delivery",
      "quantity": -20,
      "serials": [],
      "sourceNumber": "LS-2026-0211",
      "sourceTransactionId": "2f6b1d84-7c3e-4a5b-9e21-6a0c4d8b1e03",
      "warehouseId": "HAUPT"
    },
    {
      "actor": {
        "kind": "user",
        "name": "David Richter",
        "ref": "david.richter@muster-it.example"
      },
      "articleId": "4b7d9f13-5e6a-4c8b-a1d2-3e4f5a6b7c03",
      "createdAt": "2026-10-08T09:30:00Z",
      "id": "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d01",
      "kind": "goods_receipt",
      "quantity": 150,
      "serials": [],
      "sourceNumber": "WE-2026-00037",
      "sourceTransactionId": "3d6e7f8a-9b0c-4d1e-8f2a-4b5c6d7e8f37",
      "warehouseId": "HAUPT"
    }
  ],
  "total": 3
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/stock/string/movements' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
