Get Discounts

GET {{baseUrl}}/experimental/savings/v0/discounts?filter.productId=7495563456235&filter.locationId=98989898&page.size=1&page.offset=0

Provides the discounted price and related details, such as the time period the price is valid during, for one or more specified products at a single location or chain.

One of the following parameters are required:

  • filter.locationId: the unique ID for a specific store.
  • filter.chain: the unique name for a specific chain of stores.

Request Params

KeyDatatypeRequiredDescription
filter.productIdnumber(Required) One or more unique identifiers of the products(s) to get discounts for. For more than one item, the list must be comma-separated. Maximum of 50 products per call. To get a specific productId, use the /products endpoint.
filter.locationIdnumberA single id of the store location to get discounts for, retrieved from the /locations endpoint. When using filter.locationId, all discounts that apply to the particular location (including chain-specific discounts) are provided. If this is not present, filter.chain must be provided.
filter.chainNamestringA single chain the discounts apply to, such as KROGER or KINGSOOPERS, retrieved from the /chains endpoint. When using filter.chain, only discounts that apply broadly to the chain are provided. If this is not present, filter.locationId must be provided.
page.sizenumberThe number of results to return.
page.offsetnumberThe index of the first item to return, using a 0-based index.

HEADERS

KeyDatatypeRequiredDescription
Accept-LanguagestringThe language or locale accepted by the client application.
x-mock-response-codenumberUsed to specify the type of response to receive from the mock service. Indicate the desired response code from available codes on this service: 200, 400.

RESPONSES

status: OK

{"data":[{"id":"82c6b2fb-3184-4e86-82c9-fa33002fdb09","versionKey":"5692cc40af18","productId":"7495563456235","title":"Save $1.00 on 2 Cereals","description":"Save $1.00 on 2 Cereals when you buy TWO (2) BOXES cereal listed, any flavor...\n","startDatetime":{"value":"2021-09-22T00:00:00Z","timezone":"America/New_York"},"endDatetime":{"value":"2021-10-22T11:59:59","timezone":"America/New_York"},"discountedPrice":"quis dolor nisi dolore","url":"https://www.kroger.com/discounts/82c6b2fb-3184-4e86-82c9-fa33002fdb09","thumbnailUrl":"http://www.kroger.com/discount_1234149.png"}],"meta":{"page":{"offset":0,"size":1,"hasMore":false}}}