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,workfloworpublic.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 ofgoods_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 ascursorfor the next page; absent on the last one.
Example 200 answer:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/stock/string/movements' \
-H "Authorization: Bearer $ACCESS_TOKEN"