# Get Inventory Info for Multiple Products

## Overview

To retrieve metadata for existing inventory, you must:

- Be an authenticated user

Information on how you can authenticate: [Authentication](https://developer.sellercloud.com/dev-article/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.<br>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:<br>0 = NotInProductGroup,<br>1 = InProductGroup,<br>-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.

```json
{
  "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
}
```