Logo
The Kroger Co.'s Public API Documentation

Location list

GET {{kroger-baseUrl}}/locations?filter.zipCode.near=<string>&filter.latLong.near=<string>&filter.lat.near=<string>&filter.lon.near=<string>&filter.radiusInMiles=10&filter.limit=10&filter.chain=<string>&filter.department=<string>

Provides access to a list of locations matching a given criteria. If the parameter filter.chain is not provided, the results include all locations and chains owned by The Kroger Co.

Starting Point Required

You must include one of the following parameters as a starting point to narrow search results:

  • filter.zipCode.near
  • filter.latLong.near
  • filter.lat.near and filter.lon.near

If you do not provide a starting point or provide more than one starting point, an error warning is returned. By default, the results are limited to 10 locations within a 10-mile radius of the provided starting point. If you would like to extend the search results, you can use the parameter filter.radiusInMiles to set a new mile radius or filter.limit to set the number of results returned.

 

Body PARAM

Key Datatype Required Description 
filter.zipCode.near
string The zip code you want to use as a starting point for results.
filter.latLong.near
string The latitude and longitude you want to use as a starting point for results.
filter.lat.near
string The latitude you want to use as a starting point for results.
filter.lon.near
string The longitude you want to use as a starting point for results.
filter.radiusInMiles
number The mile radius you want results limited to.
filter.limit
number The number of results you want returned.
filter.chain
string
Curl
curl -X GET 'kroger-baseUrl/locations?filter.zipCode.near=<string>&filter.latLong.near=<string>&filter.lat.near=<string>&filter.lon.near=<string>&filter.radiusInMiles=10&filter.limit=10&filter.chain=<string>&filter.department=<string>?filter.zipCode.near=<string>&filter.latLong.near=<string>&filter.lat.near=<string>&filter.lon.near=<string>&filter.radiusInMiles=10&filter.limit=10&filter.chain=<string>&filter.department=<string>'

ENDPOINTS