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 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.

Request Params

KeyDatatypeRequiredDescription
filter.zipCode.nearstring
filter.latLong.nearstring
filter.lat.nearstring
filter.lon.nearstring
filter.radiusInMilesnumber
filter.limitnumber
filter.chainstring
filter.departmentstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;address&quot;:{&quot;addressLine1&quot;:&quot;\u003cstring\u003e&quot;,&quot;addressLine2&quot;:&quot;\u003cstring\u003e&quot;,&quot;city&quot;:&quot;\u003cstring\u003e&quot;,&quot;county&quot;:&quot;\u003cstring\u003e&quot;,&quot;state&quot;:&quot;\u003cstring\u003e&quot;,&quot;zipCode&quot;:&quot;\u003cstring\u003e&quot;},&quot;chain&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;departments&quot;:[{&quot;departmentId&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;hours&quot;:{&quot;Open24&quot;:&quot;\u003cboolean\u003e&quot;,&quot;monday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;tuesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;wednesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;thursday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;friday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;saturday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;sunday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;}}},{&quot;departmentId&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;hours&quot;:{&quot;Open24&quot;:&quot;\u003cboolean\u003e&quot;,&quot;monday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;tuesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;wednesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;thursday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;friday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;saturday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;sunday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;}}}],&quot;geolocation&quot;:{&quot;latLng&quot;:&quot;\u003cstring\u003e&quot;,&quot;latitude&quot;:&quot;\u003cnumber\u003e&quot;,&quot;longitude&quot;:&quot;\u003cnumber\u003e&quot;},&quot;hours&quot;:{&quot;Open24&quot;:&quot;\u003cboolean\u003e&quot;,&quot;gmtOffset&quot;:&quot;\u003cstring\u003e&quot;,&quot;timezone&quot;:&quot;\u003cstring\u003e&quot;,&quot;friday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;monday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;saturday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;sunday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;thursday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;tuesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;wednesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;}},&quot;locationId&quot;:&quot;\u003cstring\u003e&quot;,&quot;storeNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;divisionNumber&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;address&quot;:{&quot;addressLine1&quot;:&quot;\u003cstring\u003e&quot;,&quot;addressLine2&quot;:&quot;\u003cstring\u003e&quot;,&quot;city&quot;:&quot;\u003cstring\u003e&quot;,&quot;county&quot;:&quot;\u003cstring\u003e&quot;,&quot;state&quot;:&quot;\u003cstring\u003e&quot;,&quot;zipCode&quot;:&quot;\u003cstring\u003e&quot;},&quot;chain&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;departments&quot;:[{&quot;departmentId&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;hours&quot;:{&quot;Open24&quot;:&quot;\u003cboolean\u003e&quot;,&quot;monday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;tuesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;wednesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;thursday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;friday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;saturday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;sunday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;}}},{&quot;departmentId&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;hours&quot;:{&quot;Open24&quot;:&quot;\u003cboolean\u003e&quot;,&quot;monday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;tuesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;wednesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;thursday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;friday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;saturday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;sunday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;}}}],&quot;geolocation&quot;:{&quot;latLng&quot;:&quot;\u003cstring\u003e&quot;,&quot;latitude&quot;:&quot;\u003cnumber\u003e&quot;,&quot;longitude&quot;:&quot;\u003cnumber\u003e&quot;},&quot;hours&quot;:{&quot;Open24&quot;:&quot;\u003cboolean\u003e&quot;,&quot;gmtOffset&quot;:&quot;\u003cstring\u003e&quot;,&quot;timezone&quot;:&quot;\u003cstring\u003e&quot;,&quot;friday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;monday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;saturday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;sunday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;thursday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;tuesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;},&quot;wednesday&quot;:{&quot;open&quot;:&quot;\u003cstring\u003e&quot;,&quot;close&quot;:&quot;\u003cstring\u003e&quot;,&quot;open24&quot;:&quot;\u003cboolean\u003e&quot;}},&quot;locationId&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&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;]}}