For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DocumentationAPI Reference
DocumentationAPI Reference
  • API Reference
      • POSTQuery Inventory History Events
LogoLogo
API ReferenceInventory History

Query Inventory History Events

||View as Markdown|
POST
https://sandbox-api.shipbob.com/2026-01/inventory/history:query
POST
/2026-01/inventory/history:query
$curl -X POST https://sandbox-api.shipbob.com/2026-01/inventory/history:query \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "cursor": 0,
>  "end_date": "2019-08-24T14:15:22+00:00",
>  "event_category": "string",
>  "facility_id": 0,
>  "inventory_ids": [
>    0
>  ],
>  "merchant_user_id": 0,
>  "start_date": "2019-08-24T14:15:22+00:00"
>}'
200default
1{
2  "data": [
3    {
4      "additional_reference": [
5        {
6          "key": "string",
7          "value": "string"
8        }
9      ],
10      "decrement": {
11        "committed_quantity_change": 0,
12        "expiration_date": "2019-08-24T14:15:22+00:00",
13        "facility_id": 0,
14        "inventory_status": "string",
15        "location_id": 0,
16        "lot_number": "string",
17        "operational_stage": {
18          "description": "string",
19          "id": 0
20        },
21        "pack_description_id": {
22          "random": "string",
23          "time": "2019-08-24T14:15:22+00:00"
24        },
25        "quantity_change": 0,
26        "sku": "string",
27        "yuki_id": {
28          "random": "string",
29          "time": "2019-08-24T14:15:22+00:00"
30        }
31      },
32      "event_category": "string",
33      "event_datetime": "2019-08-24T14:15:22+00:00",
34      "increment": {
35        "committed_quantity_change": 0,
36        "expiration_date": "2019-08-24T14:15:22+00:00",
37        "facility_id": 0,
38        "inventory_status": "string",
39        "location_id": 0,
40        "lot_number": "string",
41        "operational_stage": {
42          "description": "string",
43          "id": 0
44        },
45        "pack_description_id": {
46          "random": "string",
47          "time": "2019-08-24T14:15:22+00:00"
48        },
49        "quantity_change": 0,
50        "sku": "string",
51        "yuki_id": {
52          "random": "string",
53          "time": "2019-08-24T14:15:22+00:00"
54        }
55      },
56      "inventory_audit_event_id": 0,
57      "inventory_id": 0,
58      "merchant_user_id": 0,
59      "shipbob_order_id": 0
60    }
61  ],
62  "first": "string",
63  "last": "string",
64  "next": "string",
65  "prev": "string"
66}

Fetches inventory movement events that change on-hand quantities within the ShipBob network. Returns events such as receiving/stow, order picks, adjustments, restocks, and attribute updates. Filter by inventory IDs, event category, date range, and facility. Supports cursor-based pagination for large result sets.

Was this page helpful?
Previous

Get Inventory Distributions by WRO ID

Next

Get Tracking by Tracking Ids

Built with

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

OR
AuthorizationBearer
OAuth2 authentication using JWT tokens

Query parameters

cursorintegerOptional

Request

cursorintegerOptional

Optional. Pagination cursor using the inventory_audit_event_id from the previous response. Returns events after this ID.

end_datedatetimeOptional
Optional. End date for filtering events. If omitted, defaults to current date.
event_categorystringOptional

Optional. Filter by event type: OrderPicked, InventoryAdjusted, InventoryFacilityUpdated, AttributeUpdated, InventoryReceived, InventoryRestocked, ReceivingStow, or KittingStow.

facility_idintegerOptional
Required. The ShipBob fulfillment center ID where the inventory events occurred.
inventory_idslist of integersOptional
Optional. Filter by specific inventory IDs. Returns events for these inventories only.
merchant_user_idintegerOptional
Optional. Filter by merchant user ID. Returns events associated with this user.
start_datedatetimeOptional
Optional. Start date for filtering events. If omitted, defaults to 90 days ago. Maximum range is 90 days.

Response

OK
datalist of objects
Array of inventory history events matching the query criteria.
firststring
URL to retrieve the first page of results.
laststring
URL to retrieve the last page of results.
nextstring
URL to retrieve the next page of results. Null if no more results available.
prevstring
URL to retrieve the previous page of results. Null if on the first page.