Skip to content

List inventory transactions

Request

Returns inventory transactions across all sales channels belonging to the authenticated merchant.

See the Pagination section in the API overview above for details on how pagination works.

Security
BearerAuth
Query
limitinteger, [ 1 .. 100 ]

Number of items to return per page (for pagination)

Default:20
created_at[gt]string, (date-time)

Filter results created after this date (ISO 8601 format)

created_at[lt]string, (date-time)

Filter results created before this date (ISO 8601 format)

created_at[gte]string, (date-time)

Filter results created on or after this date (ISO 8601 format)

created_at[lte]string, (date-time)

Filter results created on or before this date (ISO 8601 format)

sku_id[in]Array of integers, (int64)

Filter results by one or more SKU IDs. The same filter can be sent as repeated sku_id[in][] parameters instead.

sku_id[in][]Array of integers, (int64)

The sku_id[in] filter sent as repeated parameters, one SKU ID each (sku_id[in][]=1&sku_id[in][]=2). Accepts the same values as sku_id[in]. Use either form.

trigger_action[in]Array of strings

Filter results by one or more inventory transaction trigger actions. Any other value returns 400. Valid actions: storage_box_add_manually, storage_box_reduce_manually, storage_box_reduce_b2b, storage_box_add_missing, storage_box_reduce_missing, storage_box_add_problem_solving, storage_box_reduce_problem_solving, storage_box_add_reshuffling, storage_box_reduce_reshuffling, storage_box_reduce_picked, storage_box_reduce_b2c_picked, storage_box_reduce_b2b_picked, storage_box_reduce_kit_picked, storage_box_reduce_ito_picked, storage_box_add_restocking, storage_box_add_return, storage_box_add_merchant_restocking, storage_box_add_kit_restocking, storage_box_add_ito_restocking, storage_box_reduce_release_empty_box, storage_box_reduce_from_packing_station, storage_box_reduce_for_replenishment, storage_box_add_after_investigation, storage_box_reduce_after_investigation, storage_box_reduce_wrong_sku, storage_box_add_corrected_sku, storage_box_reduce_wrong_batch, storage_box_add_corrected_batch, storage_box_correction_restocking, storage_box_reduce_damaged, storage_box_disposal_request, storage_box_send_back_request.

curl -i -X GET \
  'https://developers.hive.app/_mock/merchant-api-v2/mapi_v2_oas31/inventory/transactions?limit=20&created_at%5Bgt%5D=2019-08-24T14%3A15%3A22Z&created_at%5Blt%5D=2019-08-24T14%3A15%3A22Z&created_at%5Bgte%5D=2019-08-24T14%3A15%3A22Z&created_at%5Blte%5D=2019-08-24T14%3A15%3A22Z&sku_id%5Bin%5D=0&sku_id%5Bin%5D%5B%5D=0&trigger_action%5Bin%5D=string' \
  -H 'Authorization: Bearer <YOUR_token_HERE>'

Responses

A list of inventory transactions

Bodyapplication/json
dataArray of objects(InventoryTransaction)
paginationobject(Pagination)
Example:
{
  "first_page_url": "https://app.hive.app/merchant_api/v2/collection_of_items?limit=20",
  "limit": 20,
  "next_page_url": "https://app.hive.app/merchant_api/v2/collection_of_items?limit=20&page=eyJpZCI6MTIzNDU2fQ"
}
Response
{
  "data": [
    { … }
  ],
  "pagination": {
    "first_page_url": "https://app.hive.app/merchant_api/v2/collection_of_items?limit=20",
    "limit": 20,
    "next_page_url": "https://app.hive.app/merchant_api/v2/collection_of_items?limit=20&page=eyJpZCI6MTIzNDU2fQ"
  }
}