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
      • GETList inventory items
      • GETGet an inventory item
    • OpenAPI spec
LogoLogo
API ReferenceInventory

Get an inventory item

||View as Markdown|
GET
/1.0/inventory/:inventoryId
GET
/1.0/inventory/:inventoryId
$curl https://api.shipbob.com/1.0/inventory/inventoryId \
>     -H "Authorization: Bearer <token>"
1{
2  "dimensions": {
3    "depth": 0.1,
4    "length": 0.1,
5    "weight": 0.1,
6    "width": 0.1
7  },
8  "fulfillable_quantity_by_fulfillment_center": [
9    {
10      "awaiting_quantity": 0,
11      "committed_quantity": 0,
12      "fulfillable_quantity": 0,
13      "id": 0,
14      "internal_transfer_quantity": 0,
15      "name": "Cicero",
16      "onhand_quantity": 0
17    }
18  ],
19  "fulfillable_quantity_by_lot": [
20    {
21      "awaiting_quantity": 0,
22      "committed_quantity": 0,
23      "expiration_date": "2019-08-24T14:15:22Z",
24      "fulfillable_quantity": 0,
25      "fulfillable_quantity_by_fulfillment_center": [
26        {
27          "awaiting_quantity": 0,
28          "committed_quantity": 0,
29          "fulfillable_quantity": 0,
30          "id": 0,
31          "internal_transfer_quantity": 0,
32          "name": "Cicero",
33          "onhand_quantity": 0
34        }
35      ],
36      "internal_transfer_quantity": 0,
37      "lot_number": "1234",
38      "onhand_quantity": 0
39    }
40  ],
41  "id": 0,
42  "is_active": true,
43  "is_case_pick": true,
44  "is_digital": true,
45  "is_lot": true,
46  "name": "Medium Blue T-Shirt",
47  "packaging_attribute": "None",
48  "total_awaiting_quantity": 0,
49  "total_backordered_quantity": 0,
50  "total_committed_quantity": 0,
51  "total_exception_quantity": 0,
52  "total_fulfillable_quantity": 0,
53  "total_internal_transfer_quantity": 0,
54  "total_onhand_quantity": 0,
55  "total_sellable_quantity": 0
56}
Was this page helpful?
Previous

List inventory items

Next

Create Warehouse Receiving Order (DEPRECATED)

Built with

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

OR
AuthorizationBearer
OAuth2 authentication using JWT tokens

Path parameters

inventoryIdstringRequiredformat: "int32"
The inventory id to get

Response

Success
dimensionsobject
Information about an inventory item's dimensions
fulfillable_quantity_by_fulfillment_centerlist of objects or null
Fulfillable quantity of this inventory item broken down by fulfillment center location
fulfillable_quantity_by_lotlist of objects or null
Fulfillable quantity of this inventory item broken down by lot
idinteger
Unique id of the inventory item
is_activeboolean
Whether the inventory is active or not
is_case_pickboolean
True if the inventory item is marked as case pick
is_digitalboolean
True if the inventory item is marked as a digital item
is_lotboolean
True if this inventory item is organized into lots
namestring or null
Name of the inventory item
packaging_attributeenum
total_awaiting_quantityinteger
Total quantity in unreceived receiving orders for this inventory item
total_backordered_quantityinteger

The amount of the item you need to send to ShipBob to fulfill all exception orders containing the item. This is the exception_quantity less the fulfillable_quantity of the item.

total_committed_quantityinteger
Total committed quantity of this inventory item
total_exception_quantityinteger

The total quantity of all items that are contained within orders that are in exception/out of stock status. Out of stock orders have not been processed and therefore do not have lot or fulfillment centers assigned.

total_fulfillable_quantityinteger
Total fulfillable quantity of this inventory item
total_internal_transfer_quantityinteger
The total quantity of all items that are in the process of internal transit between ShipBob fulfillment centers. These items are not pickable or fulfillable until they have been received and moved to the "On Hand" quantity of the destination FC. Internal transit quantities for each FC represent the incoming transfer stock for that specific location.
total_onhand_quantityinteger
Total onhand quantity of this inventory item
total_sellable_quantityinteger
Total quantity that can be sold without overselling the inventory item. This is calculated by subtracting the total exception quantity from the fulfillable quantity.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error