Overview
To retrieve metadata for existing inventory, you must:
- Be an authenticated user
Information on how you can authenticate: Authentication
As soon as you authenticate and receive a valid token, it needs to be passed on the call for getting inventory.
- The user can provide page number and page size, filtering, or sorting information.
Endpoint
Example for such endpoint for XX server: https://xx.api.sellercloud.com/rest/api/inventory?pageNumber=1&pageSize=1
Request
- Method Type: HttpGet
- Authorization: Use Bearer Token + token received from token authentication
- Header info: Content-Type: application/json
- Parameters:
| Parameters | Data Type | Description | Is Required |
| pageNumber | integer | Page number that will be retrieved. If the page number is not set in the request, then only 1st page will be pulled. | no |
| pageSize | integer | Number of products per page. If not set in the request, then the top 10 products will be pulled.
The maximum number of products that can be pulled with a single call is 50. |
no |
| inventoryID | List | List of IDs of inventory. | no |
| poID | List | List of IDs of purchase orders. | no |
| companyID | List | List of IDs of different companies. | no |
| vendorID | List | List of IDs of vendors. | no |
| defaultVendorID | List | List of IDs of default vendors. | no |
| brandIds | List | List of brand IDs. | no |
| vendorSKU | List | List of SKUs of vendors. | no |
| warehouse | List | List of IDs of warehouses. | no |
| upc | integer | Universal Product Code number. | no |
| physicalQtyFrom | integer | Minimum physical quantity. | no |
| physicalQtyTo | integer | Maximum physical quantity. | no |
| kitType | integer | Independant=0, MainComponent=1, AllComponents=2 | no |
| productGroupFilterType | List | Product Group Filter Operator:
0 = NotInProductGroup, 1 = InProductGroup, -1 = All. |
no |
| productGroup | List | Product Group ID. Used in combination with ProductGroupFilterType. | no |
| LastUpdatedFrom | datetime | Datetime indicating from when was last modified. | no |
| LastUpdatedTo | datetime | Datetime indicating to when was last modified. | no |
| LastAggregateFrom | datetime | From last aggregation date. | no |
| LastAggregateTo | datetime | To last aggregation date. | no |
| Keyword | string | A search term for performing a global search. | no |
Response
- If the user is authenticated and provides a valid page number and page size, then the response will be Status Code 200 => OK and inventory metadata in JSON format.
- If the user is not authenticated, then the response will be Status Code 401 => Not Valid Token.
- On server response => Status Code 500 => Internal Server Error.
Response Body
Note: If the Apply Rebates Of Parent To Shadows client setting is enabled in Sellercloud, this call will pull rebate information from the parent when pulling details for a Shadow product.
{
"Items": [
{
"ImageUrl": "string",
"Weight": "string",
"ShippingWeight": "string",
"WeightOz": 0,
"PackageWeightLbs": 0,
"PackageWeightOz": 0,
"LocationNotes": "string",
"CompanyID": 0,
"ShadowOf": "string",
"AverageCost": 0,
"Priority": 0,
"Rating": 0,
"ProductName": "string",
"DefaultVendorSKU": "string",
"QtyPerCase": 0,
"QtySold15": 0,
"QtySold30": 0,
"QtySold60": 0,
"QtySold90": 0,
"QtySold180": 0,
"QtySold365": 0,
"QtySoldYTD": 0,
"IsEndOfLife": true,
"ShippingCost": 0,
"AggregateQty": 0,
"ASIN": "string",
"AggregatePhysicalQtyFBA": 0,
"ASINInActiveListing": "string",
"ShippingWidth": 0,
"ShippingHeight": 0,
"ShippingLength": 0,
"LocationRegion": 0,
"RegionName": "string",
"WeightLbs": 0,
"ProductType": "string",
"DefaultVendor": "string",
"UnitOfMeasure": 0,
"ProductUnitOfMeasure": "string",
"HomeCountryCode": 0,
"Country": "string",
"AmazonMarketPlaceID": "string",
"CompanyName": "string",
"CompanyNameAbbreviation": "string",
"WarehouseBasedPhysicalAndReservedQty": true,
"WarehousePhysicalQty": 0,
"WarehousePhysicalQtyValue": 0,
"WarehouseReservedQtyValue": 0,
"AggregatedQty": 0,
"AggregatePhysicalSellableQtyIncludingPhysicalValue": 0,
"PhysicalQty": 0,
"ReservedQty": 0,
"ReserveQtyTotalValue": 0,
"AggregateNonSellableQty": 0,
"StorePrice": 0,
"ListPrice": 0,
"ManufacturerSKU": "string",
"UPC": "string",
"EAN": "string",
"AmazonFBASKU": "string",
"FulfilledBy": "string",
"SalesRank": 0,
"ProductConditionName": "string",
"NotesCount": 0,
"FirstKitChild": "string",
"WarehouseName": "string",
"IsSellAble": true,
"WarehouseCount": 0,
"OrderReserveTotal": 0,
"ExpectedDeliveryDate": "2026-01-22T15:02:01.711Z",
"CreationDate": "2026-01-22T15:02:01.711Z",
"BrandName": "string",
"ActiveStatus": "string",
"ActiveRebateID": 0,
"ActiveRebateValue": 0,
"ActiveRebateDeductFromItemCost": 0,
"DeductFromItemCostType": 0,
"ActiveRebateStartDate": "2026-01-22T15:02:01.711Z",
"ActiveRebateEndDate": "2026-01-22T15:02:01.711Z",
"ActiveRebateModifiedOn": "2026-01-22T15:02:01.711Z",
"InventoryLowStockNotice": 0,
"Status": 0,
"InventoryDependantOption": 0,
"OnOrder": 0,
"AmazonPrice": 0,
"WebsitePrice": 0,
"VendorID": 0,
"VendorVisible": true,
"LastAggregateDate": "2026-01-22T15:02:01.711Z",
"LastModifiedDate": "2026-01-22T15:02:01.711Z",
"AmazonMarketplace": "string",
"OnBackOrder": 0,
"BackOrderVisible": true,
"WholeSalePrice": 0,
"WholeSalePriceVisible": true,
"SitePrice": 0,
"SiteCost": 0,
"IsKit": true,
"SiteCostVisible": true,
"LastCost": 0,
"LastCostVisible": true,
"ShowPriorityAndRatingDelta": true,
"InventoryAvailableQty": 0,
"ChildProducts": [
{
"ProductId": "string",
"ChildProductId": "string",
"PerKitQty": 0,
"ProductName": "string"
}
],
"CustomColumns": [
{
"ID": 0,
"DataType": 0,
"DataLength": 0,
"IsDropDownColumn": true,
"IsDropDownCustomTextAllowed": true,
"IsDropDownAllowMultipleSelection": true,
"ClientID": 0,
"NewValue": {},
"AllowHTMLPopup": true,
"DataSourceContainer": [
{
"Key": "string",
"Value": "string",
"Additional": {}
}
],
"IsRequired": true,
"IsEnabledForClient": true,
"DataTypeName": "string",
"ColumnName": "string",
"DisplayName": "string",
"Value": {}
}
],
"AmazonStoreStatus": true,
"AmazonEnableBOPISProduct": true,
"TaxExempt": true,
"ID": "string"
}
],
"TotalResults": 0
}