Get All Inventory Levels Grouped By Lot

curl -G https://api.shipbob.com/2026-07/inventory-level/lots \
     -H "Authorization: Bearer <token>" \
     -d SearchBy=string \
     -d InventoryIds=0 \
     -d IsActive=true \
     -d IsDigital=true \
     -d SortBy=string

{
  "first": "string",
  "items": [
    {
      "inventory_id": 0,
      "lots": [
        {
          "awaiting_quantity": 0,
          "committed_quantity": 0,
          "damaged_quantity": 0,
          "exception_quantity": 0,
          "fulfillable_quantity": 0,
          "in_fulfillment_quantity": 0,
          "internal_transfer_quantity": 0,
          "locations": [
            {
              "awaiting_quantity": 0,
              "committed_quantity": 0,
              "damaged_quantity": 0,
              "exception_quantity": 0,
              "fulfillable_quantity": 0,
              "in_fulfillment_quantity": 0,
              "internal_transfer_quantity": 0,
              "location_id": 0,
              "name": "string",
              "on_hand_quantity": 0,
              "quarantine_quantity": 0
            }
          ],
          "lot_date": "2019-08-24T14:15:22+00:00",
          "lot_number": "string",
          "on_hand_quantity": 0,
          "quarantine_quantity": 0
        }
      ],
      "name": "string",
      "sku": "string"
    }
  ],
  "last": "string",
  "next": "string",
  "prev": "string"
}

Retrieves inventory levels for all inventory items grouped by lot number. Enables tracking of inventory across multiple lots, including expiration dates and manufacturing batch information.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

AuthorizationBearer

OAuth2 authentication using JWT tokens

Query parameters

LocationIdintegerOptional

SearchBystringOptional

InventoryIdslist of integersOptional

IsActivebooleanOptional

IsDigitalbooleanOptional

PageSizeintegerOptional

SortBystringOptional

Sort results by field name. Valid fields: id, inventory_id, name, sku, fulfillable_quantity, on_hand_quantity, committed_quantity, awaiting_quantity, internal_transfer_quantity, in_fulfillment_quantity, exception_quantity. Results are returned in ascending order by default; append ’ desc’ to a field for descending order (e.g., ‘on_hand_quantity desc’ sorts by on-hand quantity descending).

Sort results by field name. Valid fields: id, inventory_id, name, sku, fulfillable_quantity, on_hand_quantity, committed_quantity, awaiting_quantity, internal_transfer_quantity, in_fulfillment_quantity, exception_quantity. Results are returned in ascending order by default; append ' desc' to a field for descending order (e.g., 'on_hand_quantity desc' sorts by on-hand quantity descending).

Response

firststring or nullOptional

itemslist of objects or nullOptional

laststring or nullOptional

nextstring or nullOptional

prevstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

503

Service Unavailable Error