Query Inventory History Events | ShipBob Developer API

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"
}'

{
  "data": [
    {
      "additional_reference": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "decrement": {
        "committed_quantity_change": 0,
        "expiration_date": "2019-08-24T14:15:22+00:00",
        "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:22+00:00"
        },
        "quantity_change": 0,
        "sku": "string",
        "yuki_id": {
          "random": "string",
          "time": "2019-08-24T14:15:22+00:00"
        }
      },
      "event_category": "string",
      "event_datetime": "2019-08-24T14:15:22+00:00",
      "increment": {
        "committed_quantity_change": 0,
        "expiration_date": "2019-08-24T14:15:22+00:00",
        "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:22+00:00"
        },
        "quantity_change": 0,
        "sku": "string",
        "yuki_id": {
          "random": "string",
          "time": "2019-08-24T14:15:22+00:00"
        }
      },
      "inventory_audit_event_id": 0,
      "inventory_id": 0,
      "merchant_user_id": 0,
      "shipbob_order_id": 0
    }
  ],
  "first": "string",
  "last": "string",
  "next": "string",
  "prev": "string"
}

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.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

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

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.