iotoms Docs

List stock adjustment history for an item

GET
/api/v1/inventory/items/{itemId}/history

Returns stock movements for one item, newest first: sales, receipts, transfers and manual adjustments, each with the change, the resulting quantity and who made it. When locationId is sent, the list is every movement at that stockroom for all items, not only this item; check each row's itemId.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

itemId*string

Item code (the catalog itemId), from List items.

Query Parameters

locationId?string

Stockroom ID from List inventory locations. When sent, returns every movement at that stockroom, for all items, so filter the rows by itemId yourself. Leave out to get this item's movements across all stockrooms.

Formatuuid

Header Parameters

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request worked, ERROR when it did not.

message*string

Short human-readable message describing the result, for logs or display; do not parse it.

data?array<>|

Stock movements, newest first, each with the change, the resulting quantity and who made it.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/inventory/items/string/history'
Example Response
{  "status": "string",  "message": "string",  "data": [    {      "id": 0,      "itemId": "string",      "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",      "locationName": "string",      "adjustmentType": "string",      "deltaQty": 0,      "newQoh": 0,      "reason": "string",      "referenceId": "string",      "referenceType": "string",      "adjustedBy": "string",      "adjustedAt": "2019-08-24T14:15:22Z"    }  ]}