GET products?SKU={SKU}&WarehouseID={WarehouseID}&SupplierID={SupplierID}&EAN={EAN}&Archived={Archived}&UPC={UPC}&CategoryID={CategoryID}&ModifiedFrom={ModifiedFrom}&CreatedFrom={CreatedFrom}&CreatedTo={CreatedTo}&IncludeSuppliers={IncludeSuppliers}&IncludeVariants={IncludeVariants}&IncludeAdditionsAndSwaps={IncludeAdditionsAndSwaps}&IncludeBarcodes={IncludeBarcodes}&IncludeCustomAttributes={IncludeCustomAttributes}&IncludeCategories={IncludeCategories}&IncludeImages={IncludeImages}&IncludeStockLocations={IncludeStockLocations}&IncludeDeliveryInformation={IncludeDeliveryInformation}&ExcludeKits={ExcludeKits}&ExcludeParents={ExcludeParents}&ExcludeTaxRateCountries={ExcludeTaxRateCountries}&PageSize={PageSize}&Page={Page}&InventoryLastChangedDate={InventoryLastChangedDate}
Get Products call. Allows multiple different filters and includes. All of the includes are set to false as default. This is because a very large amount of data can be returned.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| SKU | This is an optional parameter. Set it to only get products of a particular sku. | string | None. |
| WarehouseID | This is an optional parameter. Set it to only return products for a given Warehouse. You can get a list of Warehouse from the Warehouses endpoint. | integer | Matching regular expression pattern: ^[1-9]\d*$ |
| SupplierID | This is an optional parameter. Set it to only return products for a given Supplier. You can get a list of Suppliers from the Suppliers endpoint. | integer | Matching regular expression pattern: ^[1-9]\d*$ |
| EAN | This is an optional parameter. Set it to only get products with a particular EAN. | string | None. |
| Archived | This is an optional parameter. Set it to only return archived products or non-archived products. | boolean | None. |
| UPC | This is an optional parameter. Set it to only get products with a particular UPC. | string | None. |
| CategoryID | This is an optional parameter. Set it to only return products for a given Category. You can get a list of Categories from the Categories endpoint. | integer | None. |
| ModifiedFrom | This is an optional parameter. Set it to only return products from a given modified date. This is field is a UTC time field. Your request should be like 2016-06-01T00:00:00Z | date | None. |
| CreatedFrom | This is an optional parameter. Set it to only return products from a given created from date. This is field is a UTC time field. Your request should be like 2024-12-01T00:00:00Z | date | None. |
| CreatedTo | This is an optional parameter. Set it to only return products to a given created to date. This is field is a UTC time field. Your request should be like 2024-12-02T00:00:00Z | date | None. |
| IncludeSuppliers | This is an optional parameter. Set it if you wish to return Supplier information for a product. | boolean | None. |
| IncludeVariants | This is an optional parameter. Set it if you wish to return Variant information for a product. | boolean | None. |
| IncludeAdditionsAndSwaps | This is an optional parameter. Set it Wif you wish to return Additions and swaps information for a product. | boolean | None. |
| IncludeBarcodes | This is an optional parameter. Set it if you wish to return Barcode information for a product. | boolean | None. |
| IncludeCustomAttributes | This is an optional parameter. Set it if you wish to return Custom Attribute information for a product. | boolean | None. |
| IncludeCategories | This is an optional parameter. Set it if you wish to return Category information for a product. | boolean | None. |
| IncludeImages | This is an optional parameter. Set it if you wish to return Image information for a product. | boolean | None. |
| IncludeStockLocations | This is an optional parameter. Set it if you wish to return Stock Location Information for a product i.e. Stock Location Reference, Warehouse Zone. | boolean | None. |
| IncludeDeliveryInformation | This is an optional parameter. Set it if you want to have information about next delivery date for products | boolean | None. |
| ExcludeKits | This is an optional parameter. Set it if you wish to exclude kit products from the results. | boolean | None. |
| ExcludeParents | This is an optional parameter. Set it if you wish to exclude parent products from the results. | boolean | None. |
| ExcludeTaxRateCountries | This is an optional parameter. Set it if you wish to exclude tax rate countries from the results. | boolean | None. |
| PageSize | This is an optional parameter. This will default to 100. The max page size is 100 | integer | Range: inclusive between 1 and 100 |
| Page | This is an optional parameter. It will default to page 1. | integer | Matching regular expression pattern: ^[1-9]\d*$ |
| InventoryLastChangedDate | This is optional parameter. Pass it if you want to get products whose inventory has changed after this date | date | None. |
Body Parameters
None.
Response Information
Resource Description
Get Products call. Allows multiple different filters and includes. All of the includes are set to false as default. This is because a very large amount of data can be returned.
PagedResponseModelOfProductModel| Name | Description | Type | Additional information |
|---|---|---|---|
| TotalItems | integer | None. | |
| PagingInfo | PagingFilter | None. | |
| TotalPages | integer | None. | |
| Data | Collection of ProductModel | None. |
Response Formats
application/json, text/json
Sample:
{
"TotalItems": 10,
"PagingInfo": {
"MaxPageSize": 100,
"PageSize": 1,
"Page": 1
},
"TotalPages": 10,
"Data": [
{
"ProductID": 1,
"SKU": "Shoes",
"Name": "Shoes",
"ProductGUID": "3770c461-ff74-4a2a-99b0-4f976d7a75f6",
"ProductType": "Parent",
"Suppliers": [
{
"Supplier": {
"Currency": {
"CurrencyID": 44,
"CurrencyCode": "GBP",
"CurrencyName": "British Pounds",
"Symbol": "£"
},
"SupplierID": 1,
"Name": "Supplier 1"
},
"SupplierSKU": "sup1",
"SupplierCosts": 4.5,
"SupplierStockLevel": 12,
"SupplierLeadTime": 2,
"SupplierCartonQuantities": 1,
"Priority": 0,
"SupplierMinOrderAmount": 1
}
],
"GlobalTradeIdentifiers": {
"EAN": "12345678910",
"UPC": "123456789123",
"AdditionalBarcodes": [
"barcode1",
"barcode2"
]
},
"WarehouseInformation": {
"Warehouse": {
"WarehouseName": "My Warehouse",
"WarehouseGuid": "6211420f-0dfc-4c22-8d8d-73e44bf6dd2f",
"WarehouseID": 1
},
"StockLocations": [
{
"StockLocation": {
"StockLocationID": 1234,
"StockLocationReference": "pb-1",
"LocationOrder": 1,
"Warehouse": {
"WarehouseName": "My Warehouse",
"WarehouseGuid": "c54fbde6-ec09-4d59-8647-7ecb19431ea0",
"WarehouseID": 1
},
"WarehouseZone": {
"WarehouseZoneID": 3343,
"Name": "Wz-1"
},
"StockLocationType": "Pickbin",
"IsQuarantined": false
},
"Available": 100,
"Allocated": 1,
"PhysicalStock": 101,
"PendingOut": 0,
"ExpiryDate": "2024-05-26T00:00:00",
"DeliveredDate": "2026-01-08T12:02:34.4068253Z",
"BatchReference": "reference"
}
],
"CartonQuantity": 1,
"LeadTime": 3,
"ContainsHazardousMaterials": false,
"IsFragile": false,
"UnitOfMeasure": "CM",
"Weight": 1.0,
"Dimensions": {
"HeightMM": 100.0,
"WidthMM": 102.76,
"LengthMM": 50.0
},
"Packaging": {
"PackagingID": 1,
"PackagingName": "Parcel"
},
"PackagingQuantity": 1,
"ProductTypeDescription": "shoes",
"DetailedProductTypeDescription": "Shoes and laces",
"ProductComposition": "Leather",
"ProductHarmonizedCode": "",
"RecordSerialNumberOnBarcodeDespatch": false,
"NextDeliveryDate": "2024-07-29T00:00:00",
"IsAmazonTransparency": false,
"LQDGUNCode": "LQ001",
"CountryOfManufacture": "United Kingdom",
"ManualReorderLevel": 25
},
"PricingInformation": {
"TaxClass": {
"Name": "Standard UK",
"TaxRate": 20.0,
"TaxClassID": 4
},
"Price": 15.99,
"RRP": 10.0,
"Margin": 1.5,
"AverageCost": 10.5,
"AverageCostExVat": 8.75,
"PriceIncludesVat": true,
"LastCostPrice": 0.0,
"LastCostPriceExVat": 0.0
},
"InventoryInformation": {
"Inventory": 100,
"QuarantinedInventory": 5,
"DesiredStockLevel": 9,
"Allocated": 1,
"OnBackOrder": 0,
"OnPurchaseOrder": 10,
"ManualReorderLevel": 10,
"CalculatedReorderLevel": 5,
"SoldLast7Days": 5,
"SoldLast30Days": 20,
"SoldLast60Days": 30,
"SoldLast90Days": 50,
"SoldLast120Days": 100,
"SoldLast365Days": 300,
"SoldAllTime": 633,
"AvailableInventory": 90,
"LastOrderedDate": "2026-01-06T12:02:34.4068253Z"
},
"Categories": [
{
"CategoryID": 1,
"CategoryName": "Shoes"
},
{
"CategoryID": 2,
"CategoryName": "Trainers"
}
],
"Brand": "Brand 1",
"Description": "A pair of shoes.",
"Archived": true,
"IsAkit": true,
"ProductImages": [
{
"ProductImageID": 1,
"ImageURL": "http://storefeeder.com/images/1.jpg",
"Order": 1,
"Height": 1000,
"Width": 1000
},
{
"ProductImageID": 2,
"ImageURL": "http://storefeeder.com/images/2.jpg",
"Order": 1,
"Height": 1000,
"Width": 1000
}
],
"ManufacturerPartNumber": "mfn1234",
"CreatedOnDate": "2025-12-09T12:02:34.4068253Z",
"LastModifiedDate": "2025-12-24T12:02:34.4068253Z",
"Children": [
{
"Product": {
"ProductID": 2,
"SKU": "shoe-1"
},
"VariantAttributes": [
{
"Name": "Colour",
"Value": "Red"
},
{
"Name": "Size",
"Value": "8"
}
]
},
{
"Product": {
"ProductID": 3,
"SKU": "shoe-2"
},
"VariantAttributes": [
{
"Name": "Colour",
"Value": "Red"
},
{
"Name": "Size",
"Value": "9"
}
]
},
{
"Product": {
"ProductID": 4,
"SKU": "shoe-3"
},
"VariantAttributes": [
{
"Name": "Colour",
"Value": "Blue"
},
{
"Name": "Size",
"Value": "8"
}
]
},
{
"Product": {
"ProductID": 5,
"SKU": "shoe-4"
},
"VariantAttributes": [
{
"Name": "Colour",
"Value": "Blue"
},
{
"Name": "Size",
"Value": "9"
}
]
}
],
"CustomAttributes": [
{
"CustomAttribute": {
"CustomAttributeID": 1,
"CustomAttributeName": "Material"
},
"Value": "Leather"
},
{
"CustomAttribute": {
"CustomAttributeID": 2,
"CustomAttributeName": "Includes Batteries"
},
"Value": "false"
}
],
"ProductSpecialAttribute": "Sold by the pair"
}
]
}
application/xml, text/xml
Sample:
<PagedProductModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<TotalItems>10</TotalItems>
<PagingInfo>
<PageSize>1</PageSize>
<Page>1</Page>
</PagingInfo>
<TotalPages>10</TotalPages>
<Data>
<ProductModel>
<ProductID>1</ProductID>
<SKU>Shoes</SKU>
<Name>Shoes</Name>
<ProductGUID>3770c461-ff74-4a2a-99b0-4f976d7a75f6</ProductGUID>
<ProductType>Parent</ProductType>
<Suppliers>
<ProductSupplierModel>
<SupplierSKU>sup1</SupplierSKU>
<SupplierCosts>4.50</SupplierCosts>
<SupplierStockLevel>12</SupplierStockLevel>
<SupplierLeadTime>2</SupplierLeadTime>
<SupplierCartonQuantities>1</SupplierCartonQuantities>
<Priority>0</Priority>
<SupplierMinOrderAmount>1</SupplierMinOrderAmount>
<DropShipmentDeliveryCost xsi:nil="true" />
<Supplier>
<SupplierID>1</SupplierID>
<Name>Supplier 1</Name>
<Currency>
<CurrencyID>44</CurrencyID>
<CurrencyCode>GBP</CurrencyCode>
<CurrencyName>British Pounds</CurrencyName>
<Symbol>£</Symbol>
</Currency>
</Supplier>
</ProductSupplierModel>
</Suppliers>
<GlobalTradeIdentifiers>
<EAN>12345678910</EAN>
<UPC>123456789123</UPC>
<AdditionalBarcodes>
<string>barcode1</string>
<string>barcode2</string>
</AdditionalBarcodes>
</GlobalTradeIdentifiers>
<WarehouseInformation>
<CartonQuantity>1</CartonQuantity>
<LeadTime>3</LeadTime>
<ContainsHazardousMaterials>false</ContainsHazardousMaterials>
<IsFragile>false</IsFragile>
<UnitOfMeasure>CM</UnitOfMeasure>
<Weight>1</Weight>
<Dimensions>
<HeightMM>100</HeightMM>
<WidthMM>102.76</WidthMM>
<LengthMM>50</LengthMM>
</Dimensions>
<Packaging>
<PackagingID>1</PackagingID>
<PackagingName>Parcel</PackagingName>
</Packaging>
<PackagingQuantity>1</PackagingQuantity>
<PackagingQuantityDecimal xsi:nil="true" />
<ProductTypeDescription>shoes</ProductTypeDescription>
<DetailedProductTypeDescription>Shoes and laces</DetailedProductTypeDescription>
<ProductComposition>Leather</ProductComposition>
<ProductHarmonizedCode />
<RecordSerialNumberOnBarcodeDespatch>false</RecordSerialNumberOnBarcodeDespatch>
<NextDeliveryDate>2024-07-29T00:00:00</NextDeliveryDate>
<IsAmazonTransparency>false</IsAmazonTransparency>
<LQDGUNCode>LQ001</LQDGUNCode>
<CountryOfManufacture>United Kingdom</CountryOfManufacture>
<ManualReorderLevel>25</ManualReorderLevel>
<Warehouse>
<WarehouseName>My Warehouse</WarehouseName>
<WarehouseGuid>6211420f-0dfc-4c22-8d8d-73e44bf6dd2f</WarehouseGuid>
<WarehouseID>1</WarehouseID>
</Warehouse>
<StockLocations>
<ProductStockLocationModel>
<StockLocation>
<StockLocationID>1234</StockLocationID>
<StockLocationReference>pb-1</StockLocationReference>
<LocationOrder>1</LocationOrder>
<Warehouse>
<WarehouseName>My Warehouse</WarehouseName>
<WarehouseGuid>c54fbde6-ec09-4d59-8647-7ecb19431ea0</WarehouseGuid>
<WarehouseID>1</WarehouseID>
</Warehouse>
<WarehouseZone>
<WarehouseZoneID>3343</WarehouseZoneID>
<Name>Wz-1</Name>
</WarehouseZone>
<StockLocationType>Pickbin</StockLocationType>
<IsQuarantined>false</IsQuarantined>
</StockLocation>
<Available>100</Available>
<Allocated>1</Allocated>
<PhysicalStock>101</PhysicalStock>
<PendingOut>0</PendingOut>
<ExpiryDate>2024-05-26T00:00:00</ExpiryDate>
<DeliveredDate>2026-01-08T12:02:34.4068253Z</DeliveredDate>
<BatchReference>reference</BatchReference>
</ProductStockLocationModel>
</StockLocations>
</WarehouseInformation>
<PricingInformation>
<Price>15.99</Price>
<RRP>10.00</RRP>
<Margin>1.50</Margin>
<AverageCost>10.50</AverageCost>
<AverageCostExVat>8.75</AverageCostExVat>
<PriceIncludesVat>true</PriceIncludesVat>
<LastCostPrice>0.00</LastCostPrice>
<LastCostPriceExVat>0.00</LastCostPriceExVat>
<TaxClass>
<TaxClassID>4</TaxClassID>
<Name>Standard UK</Name>
<TaxRate>20</TaxRate>
</TaxClass>
</PricingInformation>
<InventoryInformation>
<Inventory>100</Inventory>
<QuarantinedInventory>5</QuarantinedInventory>
<DesiredStockLevel>9</DesiredStockLevel>
<Allocated>1</Allocated>
<OnBackOrder>0</OnBackOrder>
<OnPurchaseOrder>10</OnPurchaseOrder>
<ManualReorderLevel>10</ManualReorderLevel>
<CalculatedReorderLevel>5</CalculatedReorderLevel>
<SoldLast7Days>5</SoldLast7Days>
<SoldLast30Days>20</SoldLast30Days>
<SoldLast60Days>30</SoldLast60Days>
<SoldLast90Days>50</SoldLast90Days>
<SoldLast120Days>100</SoldLast120Days>
<SoldLast365Days>300</SoldLast365Days>
<SoldAllTime>633</SoldAllTime>
<AvailableInventory>90</AvailableInventory>
<LastOrderedDate>2026-01-06T12:02:34.4068253Z</LastOrderedDate>
<InventoryLastChangedDate xsi:nil="true" />
</InventoryInformation>
<Categories>
<CategoryBaseModel>
<CategoryID>1</CategoryID>
<CategoryName>Shoes</CategoryName>
</CategoryBaseModel>
<CategoryBaseModel>
<CategoryID>2</CategoryID>
<CategoryName>Trainers</CategoryName>
</CategoryBaseModel>
</Categories>
<Brand>Brand 1</Brand>
<Description>A pair of shoes.</Description>
<Archived>true</Archived>
<IsAkit>true</IsAkit>
<ProductImages>
<ProductImageModel>
<ProductImageID>1</ProductImageID>
<ImageURL>http://storefeeder.com/images/1.jpg</ImageURL>
<Order>1</Order>
<Height>1000</Height>
<Width>1000</Width>
</ProductImageModel>
<ProductImageModel>
<ProductImageID>2</ProductImageID>
<ImageURL>http://storefeeder.com/images/2.jpg</ImageURL>
<Order>1</Order>
<Height>1000</Height>
<Width>1000</Width>
</ProductImageModel>
</ProductImages>
<ManufacturerPartNumber>mfn1234</ManufacturerPartNumber>
<CreatedOnDate>2025-12-09T12:02:34.4068253Z</CreatedOnDate>
<LastModifiedDate>2025-12-24T12:02:34.4068253Z</LastModifiedDate>
<Children>
<ProductChildModel>
<Product>
<ProductID>2</ProductID>
<SKU>shoe-1</SKU>
</Product>
<VariantAttributes>
<ProductVariantAttribute>
<Name>Colour</Name>
<Value>Red</Value>
</ProductVariantAttribute>
<ProductVariantAttribute>
<Name>Size</Name>
<Value>8</Value>
</ProductVariantAttribute>
</VariantAttributes>
</ProductChildModel>
<ProductChildModel>
<Product>
<ProductID>3</ProductID>
<SKU>shoe-2</SKU>
</Product>
<VariantAttributes>
<ProductVariantAttribute>
<Name>Colour</Name>
<Value>Red</Value>
</ProductVariantAttribute>
<ProductVariantAttribute>
<Name>Size</Name>
<Value>9</Value>
</ProductVariantAttribute>
</VariantAttributes>
</ProductChildModel>
<ProductChildModel>
<Product>
<ProductID>4</ProductID>
<SKU>shoe-3</SKU>
</Product>
<VariantAttributes>
<ProductVariantAttribute>
<Name>Colour</Name>
<Value>Blue</Value>
</ProductVariantAttribute>
<ProductVariantAttribute>
<Name>Size</Name>
<Value>8</Value>
</ProductVariantAttribute>
</VariantAttributes>
</ProductChildModel>
<ProductChildModel>
<Product>
<ProductID>5</ProductID>
<SKU>shoe-4</SKU>
</Product>
<VariantAttributes>
<ProductVariantAttribute>
<Name>Colour</Name>
<Value>Blue</Value>
</ProductVariantAttribute>
<ProductVariantAttribute>
<Name>Size</Name>
<Value>9</Value>
</ProductVariantAttribute>
</VariantAttributes>
</ProductChildModel>
</Children>
<CustomAttributes>
<ProductCustomAttributeModel>
<CustomAttribute>
<CustomAttributeID>1</CustomAttributeID>
<CustomAttributeName>Material</CustomAttributeName>
</CustomAttribute>
<Value>Leather</Value>
</ProductCustomAttributeModel>
<ProductCustomAttributeModel>
<CustomAttribute>
<CustomAttributeID>2</CustomAttributeID>
<CustomAttributeName>Includes Batteries</CustomAttributeName>
</CustomAttribute>
<Value>false</Value>
</ProductCustomAttributeModel>
</CustomAttributes>
<ProductSpecialAttribute>Sold by the pair</ProductSpecialAttribute>
</ProductModel>
</Data>
</PagedProductModel>