Skip to main content
POST
/
2026-01
/
inventory
/
history:query
Query Inventory History Events
curl --request POST \
  --url https://sandbox-api.shipbob.com/2026-01/inventory/history:query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cursor": 0,
  "end_date": "2019-08-24T14:15:22Z",
  "event_category": "string",
  "facility_id": 0,
  "inventory_ids": [
    0
  ],
  "merchant_user_id": 0,
  "start_date": "2019-08-24T14:15:22Z"
}
'
{
  "data": [
    {
      "additional_reference": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "decrement": {
        "committed_quantity_change": 0,
        "expiration_date": "2019-08-24T14:15:22Z",
        "facility_id": 0,
        "inventory_status": "string",
        "location_id": 0,
        "lot_number": "string",
        "operational_stage": {
          "description": "string",
          "id": 0
        },
        "pack_description_id": {
          "random": "string",
          "time": "2019-08-24T14:15:22Z"
        },
        "quantity_change": 0,
        "sku": "string",
        "yuki_id": {
          "random": "string",
          "time": "2019-08-24T14:15:22Z"
        }
      },
      "event_category": "string",
      "event_datetime": "2019-08-24T14:15:22Z",
      "increment": {
        "committed_quantity_change": 0,
        "expiration_date": "2019-08-24T14:15:22Z",
        "facility_id": 0,
        "inventory_status": "string",
        "location_id": 0,
        "lot_number": "string",
        "operational_stage": {
          "description": "string",
          "id": 0
        },
        "pack_description_id": {
          "random": "string",
          "time": "2019-08-24T14:15:22Z"
        },
        "quantity_change": 0,
        "sku": "string",
        "yuki_id": {
          "random": "string",
          "time": "2019-08-24T14:15:22Z"
        }
      },
      "inventory_audit_event_id": 0,
      "inventory_id": 0,
      "merchant_user_id": 0,
      "shipbob_order_id": 0
    }
  ],
  "first": "string",
  "last": "string",
  "next": "string",
  "prev": "string"
}

Authorizations

​
Authorization
string
header
required

Authentication using Personal Access Token (PAT) token

Query Parameters

​
cursor
string<int32>

Body

application/json
​
cursor
integer<int32> | null

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

​
end_date
string<date-time> | null

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

​
event_category
string | null

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

​
facility_id
integer<int32>

Required. The ShipBob fulfillment center ID where the inventory events occurred.

​
inventory_ids
integer<int32>[] | null

Optional. Filter by specific inventory IDs. Returns events for these inventories only.

​
merchant_user_id
integer<int32> | null

Optional. Filter by merchant user ID. Returns events associated with this user.

​
start_date
string<date-time> | null

Optional. Start date for filtering events. If omitted, defaults to 90 days ago. Maximum range is 90 days.

Response

200 - application/json

OK

​
data
object[] | null

Array of inventory history events matching the query criteria.

​
first
string | null

URL to retrieve the first page of results.

​
last
string | null

URL to retrieve the last page of results.

​
next
string | null

URL to retrieve the next page of results. Null if no more results available.

​
prev
string | null

URL to retrieve the previous page of results. Null if on the first page.