# Get Catalog Info For Multiple Products

**Table of Contents**

### Overview

You can use this endpoint to retrieve metadata for existing products with the option to specify different filtering values. For a complete set of results, multiple requests should be made by specifying a page number in the request.

To consume this endpoint, you must be an [Authenticated User](https://developer.sellercloud.com/dev-article/authentication/). As soon as you receive a valid token, you need to pass it to the call for getting catalog metadata.

### Endpoint

Example for such an endpoint for **XX** server:

`https:// xx.api.sellercloud.com/rest/api/catalog?pageNumber=1&pageSize=1`

For your server, the endpoint will be:

`https:// {your_server_id}.api.sellercloud.com/rest/api/catalog?pageNumber=1&pageSize=1`

### Request

- Method Type: **HttpGet**  
- Authorization: Use **Bearer Token** + token received from token authentication  
- Header info: **Content-Type: application/json**  
- Query parameters:

| Parameters           | Data Type | Description                                                      | Is Required |
|---------------------|-----------|------------------------------------------------------------------|-------------|
| pageNumber          | integer   | Number of pages.                                                | no          |
| pageSize            | integer   | Number of products per page.                                    | no          |
| SKU                 | List      | List of product IDs.                                           | no          |
| poID                | List      | List of IDs of purchase orders.                                | no          |
| companyID           | List      | List of IDs of companies.                                      | no          |
| vendorID            | List      | List of IDs of vendors.                                        | no          |
| defaultVendorID     | List      | List of IDs of default vendors.                                | no          |
| vendorSKU           | List      | List of SKUs of vendors.                                      | no          |
| warehouse           | List      | List of IDs of warehouses.                                     | no          |
| upc                 | integer   | Universal Product Code numbers.                                 | no          |
| physicalQtyFrom     | integer   | Minimum physical qty.                                          | no          |
| physicalQtyTo       | integer   | Maximum physical qty.                                          | no          |
| kitType             | integer   | Independant=0, MainComponent=1, AllComponents=2.              | no          |
| LastUpdatedFrom     | datetime  | Earliest Datetime indicating when the product was last modified. | no          |
| LastUpdatedTo       | datetime  | Latest Datetime indicating when the product 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          |
| displayShadows      | enum      | 0 = Non_Shadow_Only, 1 = Shadow_Only, 2 = Shadow_Parent, 3 = Not_Shadow_or_Shadow_Parent. | no          |
| selectedKits        | enum      | 0 = Not_a_Kit_Parent_or_Component, 1 = Kit_Parent, 2 = Kit_Component, 3 = Not_a_Kit_Parent, 4 = Not_a_Kit_Component.  | no          |
| activeStatus        | enum      | 0 = No, 1 = Yes, -1 = All.                                    | no          |
| dateCreatedFrom      | datetime  | Earliest date for product creation.                             | no          |
| dateCreatedTo        | datetime  | Latest date for product creation.                               | no          |
| brandIds            | list      | List of brand IDs.                                            | no          |
| productGroupFilterType| enum     | Product Group Filter Operator: 0 = NotInProductGroup, 1 = InProductGroup, -1 = All. | no          |
| productGroup        | string    | Product Group ID. Used in combination with ProductGroupFilterType. | 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 catalog 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": 0,
      "ShippingWeight": 0,
      "WeightOz": 0,
      "PackageWeightLbs": 0,
      "PackageWeightOz": 0,
      "LocationNotes": "string",
      "eBayCategory": "string",
      "eBayStoreCategory": "string",
      "eBayItemCondition": "string",
      "MAPPrice": 0,
      "ShadowOf": "string",
      "AverageCost": 0,
      "Priority": 0,
      "Rating": 0,
      "ProductName": "string",
      "ShortDescription": "string",
      "LongDescription": "string",
      "Buyer": "string",
      "ASIN": "string",
      "GTIN": "string",
      "QtySold15": 0,
      "QtySold30": 0,
      "QtySold60": 0,
      "QtySold90": 0,
      "QtySold180": 0,
      "QtySold365": 0,
      "QtySoldYTD": 0,
      "IsEndOfLife": true,
      "ShippingCost": 0,
      "AggregatePhysicalQtyFBA": 0,
      "AggregatePhysicalQty": 0,
      "AggregateQty": 0,
      "ProductType": "string",
      "DefaultVendor": "string",
      "DefaultVendorSKU": "string",
      "HomeCountryCode": 0,
      "Country": "string",
      "AmazonMarketPlaceID": "string",
      "OverstockGeneratedProductID": "string",
      "OverStockOptionSKU": "string",
      "ReverbListingID": 0,
      "WalmartProductID": "string",
      "WPID": "string",
      "ItemPageURL": "string",
      "CompanyName": "string",
      "CompanyNameAbbreviation": "string",
      "FirstKitChild": "string",
      "WarehousePhysicalQty": 0,
      "WarehousePhysicalQtyValue": 0,
      "WarehouseReservedQtyValue": 0,
      "AggregatedQty": 0,
      "AggregatePhysicalSellableQtyIncludingPhysicalValue": 0,
      "ReservedQty": 0,
      "ReserveQtyTotalValue": 0,
      "PhysicalQty": 0,
      "AggregateNonSellableQty": 0,
      "StorePrice": 0,
      "ManufacturerSKU": "string",
      "ManufacturerID": 0,
      "BrandID": 0,
      "ASINInActiveListing": "string",
      "WeightLbs": 0,
      "UPC": "string",
      "AmazonFBASKU": "string",
      "IsHazmat": true,
      "NELiveInventory": 0,
      "NEBizInventory": 0,
      "WebsiteViewURL": "string",
      "WishProductID": "string",
      "FulfilledBy": 0,
      "SalesRank": 0,
      "AmazonProductCondition": 0,
      "AmazonCondition": "string",
      "MainProductID": "string",
      "FixedPriceQuantity": 0,
      "BuyItNowPrice": 0,
      "ShippingTemplateID": "string",
      "ListPrice": 0,
      "SalePrice": 0,
      "LocalStorePrice": 0,
      "SalePriceStartDate": "2026-03-02T14:20:54.154Z",
      "SalePriceEndDate": "2026-03-02T14:20:54.154Z",
      "DropShipMode": 1,
      "eBayCategory1ID": "string",
      "eBayCategory1Name": "string",
      "eBayTopTitle": "string",
      "ProductTitleCount": 0,
      "DescriptionTemplateID": "string",
      "ebayItemID": "string",
      "ebaySiteCode": 0,
      "ProductConditionName": "string",
      "NotesCount": 0,
      "OrderReserveTotal": 0,
      "VendorOfProduct": "string",
      "VendorPrice": 0,
      "ReplacementQty": 0,
      "WarehouseName": "string",
      "IsSellAble": true,
      "WarehouseCount": 0,
      "CompanyID": 0,
      "EnabledOnChannels": [
        0
      ],
      "WebEnabled": true,
      "BuyDotComEnabled": true,
      "MagentoEnabled": true,
      "SearsEnabled": true,
      "PriceGrabberEnabled": true,
      "OverStockEnabled": true,
      "PriceFallEnabled": true,
      "UnbeatableSalesEnabled": true,
      "eBayEnabled": true,
      "AmazonEnabled": true,
      "WayfairEnabled": true,
      "VendorCentralEnabled": true,
      "BonanzaEnabled": true,
      "SmartBargainsEnabled": true,
      "ATGStoresEnabled": true,
      "BestBuyEnabled": true,
      "BestBuyDsEnabled": true,
      "KohlsEnabled": true,
      "HomeDepotEnabled": true,
      "StaplesEnabled": true,
      "MeijerEnabled": true,
      "OneStopPlusEnabled": true,
      "SonsiEnabled": true,
      "KMartEnabled": true,
      "ElevenMainEnabled": true,
      "GroupOnGoodsEnabled": true,
      "GrouponMarketplaceEnabled": true,
      "WalmartEnabled": true,
      "WalmartAPIEnabled": true,
      "WishEnabled": true,
      "JETEnabled": true,
      "EtsyEnabled": true,
      "FingerHutEnabled": true,
      "TopHatterEnabled": true,
      "TangaEnabled": true,
      "TargetEnabled": true,
      "NewEggDotComEnabled": true,
      "NewEggBizEnabled": true,
      "YahooStoreEnabled": true,
      "HayneedleEnabled": true,
      "ReverbEnabled": true,
      "DropShipCentralEnabled": true,
      "DrugStoresEnabled": true,
      "CdiscountEnabled": true,
      "BedBathAndBeyondEnabled": true,
      "ShopHQEnabled": true,
      "GoogleShoppingEnabled": true,
      "HouzzEnabled": true,
      "BackmarketEnabled": true,
      "IsMatrixParent": true,
      "MerchantSKU": "string",
      "AmazonMerchantSKU": "string",
      "WayfairMerchantSKU": "string",
      "WebsiteProductID": "string",
      "ChannelPreviews": [
        {
          "Channel": 0,
          "URL": "string"
        }
      ],
      "ActiveRebateID": 0,
      "ActiveRebateValue": 0,
      "ActiveRebateDeductFromItemCost": 0,
      "DeductFromItemCostType": 0,
      "ActiveRebateStartDate": "2026-03-02T14:20:54.155Z",
      "ActiveRebateEndDate": "2026-03-02T14:20:54.155Z",
      "ActiveRebateModifiedOn": "2026-03-02T14:20:54.155Z",
      "BrandName": "string",
      "DateCreated": "2026-03-02T14:20:54.155Z",
      "ActiveStatus": "string",
      "LightspeedPOSEnabled": true,
      "ShowLargeProductImagesOnManageCatalog": true,
      "HomeCurrencyCode": 0,
      "InventoryLowStockNotice": 0,
      "Status": 0,
      "InventoryDependantOption": 0,
      "OnOrder": 0,
      "AmazonPrice": 0,
      "WebsitePrice": 0,
      "VendorID": 0,
      "VendorVisible": true,
      "LastAggregateDate": "2026-03-02T14:20:54.155Z",
      "LastModifiedDate": "2026-03-02T14:20:54.155Z",
      "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
}
```
