List Inventory Histories

get

https://api.warehance.com/v1/inventory-histories

Required permission: read_inventory

List inventory location history records — every inventory adjustment with its old and new quantity, adjustment reason, note, the user who made it, and the related order, inbound shipment, shipment, lot, or kit assembly task where applicable.

Results can be filtered by location, product, adjustment reason, client, warehouse, and date range. Results are sorted by ID by default; pass sort_by=created_at&order_by=desc to get the most recent adjustments first.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

location_id

integer

≥ 1

Filter to history records for a single location.

product_id

integer

≥ 1

Filter to history records for a single product.

adjustment_reason

string

Filter by adjustment reason name (exact match), e.g. 'Cycle Count', 'Received Inbound Shipment', or a custom reason configured for your organization.

client_id

integer

≥ 1

Filter to history records for a single client's products. (Organization level keys only; client level keys are always scoped to their own client)

warehouse_id

integer

≥ 1

Filter to history records for locations in a single warehouse.

date_start

date-time

Only include history records created at or after this date-time.

date_end

date-time

Only include history records created at or before this date-time.

limit

integer

1 to 100

Defaults to 25

The number of records to return per page.

cursor

string

Cursor for pagination, from the 'next_cursor' field of a previous response. Omit to retrieve the first page.

sort_by

string

enum

The field to sort by.

Allowed:

order_by

string

enum

The sort direction.

Allowed:

Responses

200Inventory histories retrieved successfully

400Bad Request