Skip to main content
POST
/
commerce
/
inventory
/
v5
/
inventory
Error
A valid request URL is required to generate request examples
[
  {
    "locationName": "<string>",
    "locationCode": "<string>",
    "tenantID": 123,
    "onHand": 123,
    "available": 123,
    "allocated": 123,
    "pending": 123,
    "partNumber": "<string>",
    "upc": "<string>",
    "sku": "<string>",
    "blockAssignment": true,
    "ltd": 123,
    "floor": 123,
    "safetyStock": 123,
    "distance": 123,
    "directShip": true,
    "transferEnabled": true,
    "pickup": true,
    "countryCode": "<string>",
    "inventoryLocatorName": "<string>",
    "attributes": [
      "<string>"
    ],
    "taggedInventory": [
      {
        "onHand": 123,
        "available": 123,
        "allocated": 123,
        "pending": 123,
        "tags": {},
        "futureInventory": [
          {
            "futureInventoryID": 123,
            "onhand": 123,
            "available": 123,
            "allocated": 123,
            "pending": 123,
            "type": "<string>",
            "deliveryDate": "2023-11-07T05:31:56Z",
            "createDate": "2023-11-07T05:31:56Z"
          }
        ]
      }
    ],
    "futureInventory": [
      {
        "futureInventoryID": 123,
        "onhand": 123,
        "available": 123,
        "allocated": 123,
        "pending": 123,
        "type": "<string>",
        "deliveryDate": "2023-11-07T05:31:56Z",
        "createDate": "2023-11-07T05:31:56Z"
      }
    ],
    "externalID": "<string>",
    "success": true,
    "messages": [
      "<string>"
    ],
    "numResults": 123
  }
]

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme.

Query Parameters

x-vol-site
integer

Site ID

Body

application/json

Request to get inventory

Request for getting Inventory

type
enum<string>

Inventory Request Type Enum

Available options:
ALL,
PARTIAL,
ANY,
ALL_STORES
items
Item Quantity · object[]

List of Items to search on

requestLocation
Request Location · object

Request Location

limit
integer

The maximum number of results to return, defaults to 100 for most

locationWhitelist
string[]

List of location codes that are allowed to be included in results

locationPriorityList
string[]

List of location codes that should be returned before all others, preventing them from being excluded by limit

locationBlacklist
string[]

List of location codes that are NOT allowed to be included in results

ignoreSafetyStock
boolean

Whether to ignore the safety stock buffer put in place

includeNegativeInventory
boolean

Whether to allow items with negative inventory in the results

directShip
boolean

Whether to limit results to locations that are shipping enabled

transferEnabled
boolean

Filter results by locations that have transfer enabled (true) or don't (false)

pickup
boolean

Filter results by locations that have finderbot enabled (true) or don't (false)

includeInAggregateExport
boolean

Filter results by locations that have aggregate export enabled (true) or don't (false)

includeInLocationExport
boolean

Filter results by locations that have physical storefronts (true) or don't (false)

excludeBlockedAssignment
boolean

Filter out results that are blocked from assignment (at the product/location level)

includeAttributes
boolean

Flag to include attributes or not

includeFutureInventory
boolean

If set to true, include future inventory in response (records that were set with a deliveryDate).

includeNegativeFutureInventory
boolean

Whether to allow items with negative future inventory in the results

deliveryDateBefore
string<date-time>

DateTime to filter for only future inventory with a delivery date before or equal to the given date

deliveryDateAfter
string<date-time>

DateTime to filter for only future inventory with a delivery date after or equal to the given date

sortByEnum
enum<string>

What to sort the inventory results by. Only used for GetInventoryByLocation calls (locationCode must be set)

Available options:
ON_HAND,
AVAILABLE,
ALLOCATED,
PART_NUMBER,
PRODUCT_ID
sortDescending
boolean

Whether to sort by descending order or not. Must be used in conjunction with the sortByEnum value

forceDefaultsForUnspecifiedTagCategories
boolean

Whether to force populate default tags onto the request if they are unspecified for any tag category

tags
object

Associative Map of <String, String> for tagCategoryName => tagName

locationCode
string

Location Code

userID
integer

user id

pageSize
integer

how many results to show per page

pageNum
integer

which page to show

sortBy
string

index to sort results by

Response

Success

locationName
string

Location Name

locationCode
string

Location Code

tenantID
integer

Tenant Identifier

onHand
integer

The quantity the location has in its possession

available
integer

The quantity the location has that are available for purchase

allocated
integer

The quantity the location has that are already allocated.

pending
integer

The quantity the location has that are pending.

partNumber
string

Part/Product Number

upc
string

Universal Product Code

sku
string

Stock Keeping Unit

blockAssignment
boolean

Whether or not the product is blocked for assignment

ltd
number

Custom field used for store prioritization

floor
integer

Absolute minimum quantity of this item that should be in stock at any time

safetyStock
integer

Quantity of this item the location wants to keep in stock to ensure stock isn't completely depleted

distance
number

The distance in miles from this location to the item's destination

directShip
boolean

Whether this location can ship to a consumer

transferEnabled
boolean

Whether the location can ship to another location (store), thus restocking that location.

pickup
boolean

Whether a consumer can pick up product at this location (store)

countryCode
string

The country code of this location

inventoryLocatorName
string

The inventory locator name of the individual item

attributes
string[]

List of Inventory Attributes

taggedInventory
Tag quantity response · object[]
futureInventory
Future Inventory · object[]
externalID
string

External ID of the item

success
boolean

Flag for success

messages
string[]

List of messages

numResults
integer

Number of results