ConnectCloud Developers

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:

{
  "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"

View as Markdown · Interactive reference · OpenAPI