Warehouse stock history

Get stock logs filtered by warehouse and transaction types in a defined time period for your store. When no warehouse or transaction type is set you will get logs for all transaction types for all your warehouses.

Required permissions: WAREHOUSE_HISTORY

post

/tenants/{tenantUid}/stores/{storeUid}/warehouses/logs/search

Authorizations

AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

Body

fromDateTimestring · date-timeRequired

GTE [>=]

toDateTimestring · date-timeRequired

LTE [=<]

warehouseUidsstring[]Optional

Responses

200

Example response

application/json

post/tenants/{tenantUid}/stores/{storeUid}/warehouses/logs/search

POST /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/logs/search HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "fromDateTime": "2026-01-01T00:00:00.000Z",
  "toDateTime": "2026-01-01T00:00:00.000Z",
  "warehouseUids": [
    "text"
  ],
  "transactionTypes": [
    "RECEIVE"
  ]
}

200

Example response

{
  "items": [
    {
      "storeUid": "text",
      "storeName": "text",
      "warehouseUid": "text",
      "warehouseName": "text",
      "productUId": "text",
      "productSku": "text",
      "productName": "text",
      "costDelta": 1,
      "costNew": 1,
      "costOrigin": 1,
      "costTransaction": 1,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "quantityDelta": 1,
      "quantityNew": 1,
      "quantityNotAvailable": 1,
      "quantityOrigin": 1,
      "reference": 1,
      "referenceDetails": {
        "salesOrder": {
          "orderNumber": "text",
          "orderUid": "text",
          "storeUid": "text",
          "orderItemUid": "text"
        },
        "rmaOrder": {
          "rmaNumber": "text",
          "storeUid": "text",
          "rmaOrderUid": "text",
          "rmaOrderItemUid": "text"
        },
        "stocktaking": {
          "name": "text",
          "storeUid": "text",
          "stocktakingUid": "text",
          "stocktakingItemUid": "text"
        },
        "internalPurchaseOrder": {
          "internalPurchaseNumber": "text",
          "storeUid": "text",
          "internalPurchaseOrderUid": "text",
          "internalPurchaseOrderItemUid": "text"
        },
        "serviceOrder": {
          "serviceOrderNumber": "text",
          "storeUid": "text",
          "serviceOrderUid": "text",
          "serviceOrderItemUid": "text"
        },
        "receivement": {
          "purchaseNumber": "text",
          "storeUid": "text",
          "purchaseOrderUid": "text",
          "purchaseOrderItemUid": "text",
          "receivementUid": "text",
          "receivementItemUid": "text"
        },
        "responseType": "salesOrder"
      },
      "serialnumber": "text",
      "tenantUserUid": "text",
      "tenantUserName": "text",
      "transactionType": "RECEIVE",
      "saleCostPrice": 1
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}