Product list

GET {{kroger-baseUrl}}/products?filter.term=<string>&filter.locationId=<string>&filter.productId=<string>&filter.brand=<string>&filter.fulfillment=<string>&filter.start=<string>&filter.limit=<integer>

Provides access to a list of products. If no query parameters are provided, a list of all products is returned. To return the product price and aisle location, you must include the filter.locationId query parameters.

Note: seasonal products are returned but only have a price when available.

Request Params

KeyDatatypeRequiredDescription
filter.termstringA search term to filter product results. As an example, you could input milk, bread, or salt.
filter.locationIdstringThe locationId of the store you want results limited to. When using this filter, only products available at that location are returned.
filter.productIdstringThe productId of the products(s) you want returned. For more than one item, the list must be comma-separated. When used, all other query parameters are ignored.
filter.brandstringThe brand name of the product(s) you want returned. When using this filter, only products by that brand are returned. Brand names are case-sensitive, and lists must be pipe-separated.
filter.fulfillmentstringThe available fulfillment types of the product(s) you want returned. Fulfillment types are case-sensitive, and lists must be comma-separated. Must be one or more of the follow types: ais - Available In Store, csp - Curbside Pickup, dth - Delivery To Home, sth - Ship To Home
filter.startstringThe number of products you want to skip.
filter.limitstringThe number of products you want returned.

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;productId&quot;:&quot;\u003cstring\u003e&quot;,&quot;aisleLocations&quot;:[{&quot;bayNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;number&quot;:&quot;\u003cstring\u003e&quot;,&quot;numberOfFacings&quot;:&quot;\u003cstring\u003e&quot;,&quot;sequenceNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;side&quot;:&quot;\u003cstring\u003e&quot;,&quot;shelfNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;shelfPositionInBay&quot;:&quot;\u003cstring\u003e&quot;},{&quot;bayNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;number&quot;:&quot;\u003cstring\u003e&quot;,&quot;numberOfFacings&quot;:&quot;\u003cstring\u003e&quot;,&quot;sequenceNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;side&quot;:&quot;\u003cstring\u003e&quot;,&quot;shelfNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;shelfPositionInBay&quot;:&quot;\u003cstring\u003e&quot;}],&quot;brand&quot;:&quot;\u003cstring\u003e&quot;,&quot;categories&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;countryOrigin&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;items&quot;:[{&quot;itemId&quot;:&quot;\u003cstring\u003e&quot;,&quot;inventory&quot;:{&quot;stockLevel&quot;:&quot;\u003cstring\u003e&quot;},&quot;favorite&quot;:&quot;\u003cboolean\u003e&quot;,&quot;fulfillment&quot;:{&quot;curbside&quot;:&quot;\u003cboolean\u003e&quot;,&quot;delivery&quot;:&quot;\u003cboolean\u003e&quot;},&quot;price&quot;:{&quot;regular&quot;:&quot;\u003cnumber\u003e&quot;,&quot;promo&quot;:&quot;\u003cnumber\u003e&quot;},&quot;size&quot;:&quot;\u003cstring\u003e&quot;},{&quot;itemId&quot;:&quot;\u003cstring\u003e&quot;,&quot;inventory&quot;:{&quot;stockLevel&quot;:&quot;\u003cstring\u003e&quot;},&quot;favorite&quot;:&quot;\u003cboolean\u003e&quot;,&quot;fulfillment&quot;:{&quot;curbside&quot;:&quot;\u003cboolean\u003e&quot;,&quot;delivery&quot;:&quot;\u003cboolean\u003e&quot;},&quot;price&quot;:{&quot;regular&quot;:&quot;\u003cnumber\u003e&quot;,&quot;promo&quot;:&quot;\u003cnumber\u003e&quot;},&quot;size&quot;:&quot;\u003cstring\u003e&quot;}],&quot;itemInformation&quot;:{&quot;depth&quot;:&quot;\u003cstring\u003e&quot;,&quot;height&quot;:&quot;\u003cstring\u003e&quot;,&quot;width&quot;:&quot;\u003cstring\u003e&quot;},&quot;temperature&quot;:{&quot;indicator&quot;:&quot;\u003cstring\u003e&quot;,&quot;heatSensitive&quot;:&quot;\u003cboolean\u003e&quot;},&quot;images&quot;:[{&quot;type&quot;:&quot;boolean&quot;,&quot;default&quot;:&quot;\u003cboolean\u003e&quot;},{&quot;type&quot;:&quot;boolean&quot;,&quot;default&quot;:&quot;\u003cboolean\u003e&quot;}],&quot;upc&quot;:&quot;\u003cstring\u003e&quot;},{&quot;productId&quot;:&quot;\u003cstring\u003e&quot;,&quot;aisleLocations&quot;:[{&quot;bayNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;number&quot;:&quot;\u003cstring\u003e&quot;,&quot;numberOfFacings&quot;:&quot;\u003cstring\u003e&quot;,&quot;sequenceNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;side&quot;:&quot;\u003cstring\u003e&quot;,&quot;shelfNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;shelfPositionInBay&quot;:&quot;\u003cstring\u003e&quot;},{&quot;bayNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;number&quot;:&quot;\u003cstring\u003e&quot;,&quot;numberOfFacings&quot;:&quot;\u003cstring\u003e&quot;,&quot;sequenceNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;side&quot;:&quot;\u003cstring\u003e&quot;,&quot;shelfNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;shelfPositionInBay&quot;:&quot;\u003cstring\u003e&quot;}],&quot;brand&quot;:&quot;\u003cstring\u003e&quot;,&quot;categories&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;countryOrigin&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;items&quot;:[{&quot;itemId&quot;:&quot;\u003cstring\u003e&quot;,&quot;inventory&quot;:{&quot;stockLevel&quot;:&quot;\u003cstring\u003e&quot;},&quot;favorite&quot;:&quot;\u003cboolean\u003e&quot;,&quot;fulfillment&quot;:{&quot;curbside&quot;:&quot;\u003cboolean\u003e&quot;,&quot;delivery&quot;:&quot;\u003cboolean\u003e&quot;},&quot;price&quot;:{&quot;regular&quot;:&quot;\u003cnumber\u003e&quot;,&quot;promo&quot;:&quot;\u003cnumber\u003e&quot;},&quot;size&quot;:&quot;\u003cstring\u003e&quot;}],&quot;itemInformation&quot;:{&quot;depth&quot;:&quot;\u003cstring\u003e&quot;,&quot;height&quot;:&quot;\u003cstring\u003e&quot;,&quot;width&quot;:&quot;\u003cstring\u003e&quot;},&quot;temperature&quot;:{&quot;indicator&quot;:&quot;\u003cstring\u003e&quot;,&quot;heatSensitive&quot;:&quot;\u003cboolean\u003e&quot;},&quot;images&quot;:[{&quot;type&quot;:&quot;boolean&quot;,&quot;default&quot;:&quot;\u003cboolean\u003e&quot;},{&quot;type&quot;:&quot;boolean&quot;,&quot;default&quot;:&quot;\u003cboolean\u003e&quot;}],&quot;upc&quot;:&quot;\u003cstring\u003e&quot;}],&quot;meta&quot;:{&quot;pagination&quot;:{&quot;total&quot;:&quot;\u003cnumber\u003e&quot;,&quot;start&quot;:&quot;\u003cnumber\u003e&quot;,&quot;limit&quot;:&quot;\u003cnumber\u003e&quot;},&quot;warnings&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]}}