Kroger Locations

Provides access to a list of locations. If the parameter filter.chain is not provided, the results include all locations and chains owned by The Kroger Co. You may include one of the following parameters to narrow search results within a geographic area:

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

• filter.zipCode.near

  • Description: The zip code to use as a starting point for results.
  • Example: 45044
  • Type: string
  • Required: false
  • Query: filter.zipCode.near

• filter.latLong.near

  • Description: The latitude and longitude to use as a starting point for results.
  • Example: filter.latLong.near=39.306346,-84.278902
  • Type: string
  • Required: false
  • Query: filter.latLong.near

• filter.lat.near and filter.lon.near

  • Description: The latitude and longitude to use as a starting point for results.
  • Example: filter.lat.near=39.306346&filter.lon.near=-84.278902
  • Type: string
  • Required: false
  • Query: filter.lat.near and filter.lon.near

• filter.radiusInMiles

  • Description: The mile radius of results. This will be ignored if you do not use one of the 3 starting point filters (zipCode, latLong, or lat and lon).
  • Example: 10
  • Type: integer
  • Required: false
  • Query: filter.radiusInMiles

• filter.limit

  • Description: The number of results to return.
  • Example: 10
  • Type: integer
  • Required: false
  • Query: filter.limit

10

• filter.chain
  • Description: The chain name of the chain. When using this filter, only stores matching the provided chain name are returned.
  • Example: Kroger
  • Type: string
  • Required: false
  • Query: filter.chain

Example : Kroger

• filter.department

  • Description: The departmentId of the department. Lists must be comma-separated. When using this filter, only stores that have all of the departments provided are returned.
  • Example: 13
  • Type: string
  • Required: false
  • Query: filter.department

• filter.locationId

  • Description: Comma-separated list of locationIds.
  • Example: 01400390
  • Type: string
  • Required: false
  • Query: filter.locationId

• 200
  • Description: OK
  • Links: None

OK

• application/json
  • Controls Accept header.

{
  "data": [
    {
      "address": {
        "addressLine1": "2900 W. St. Rt. 22 & 3",
        "addressLine2": "",
        "city": "Maineville",
        "county": "WARREN COUNTY",
        "state": "OH",
        "zipCode": "45039"
      },
      "chain": "KROGER",
      "phone": "5551234567",
      "departments": [
        {
          "departmentId": "01",
          "name": "Drug & General Merchandise",
          "phone": "5551234567",
          "hours": {
            "Open24": false,
            "monday": {
              "open": "05:00",
              "close": "1380",
              "open24": false
            },
            "tuesday": {
              "open": "05:00",
              "close": "1380",
              "open24": false
            },
            "wednesday": {
              "open": "05:00",
              "close": "1380",
              "open24": false
            },
            "thursday": {
              "open": "05:00",
              "close": "1380",
              "open24": false
            },
            "friday": {
              "open": "05:00",
              "close": "1380",
              "open24": false
            },
            "saturday": {
              "open": "05:00",
              "close": "1380",
              "open24": false
            },
            "sunday": {
              "open": "05:00",
              "close": "1380",
              "open24": false
            }
          }
        }
      ],
      "geolocation": {
        "latLng": "39.3110881,-84.2751167",
        "latitude": 39.3110881,
        "longitude": -84.2751167
      },
      "hours": {
        "Open24": true,
        "gmtOffset": "(UTC-05:00) Eastern Time (US Canada)",
        "timezone": "America/New_York",
        "friday": {
          "open": "05:00",
          "close": "1380",
          "open24": false
        },
        "monday": {
          "open": "05:00",
          "close": "1380",
          "open24": false
        },
        "saturday": {
          "open": "05:00",
          "close": "1380",
          "open24": false
        },
        "sunday": {
          "open": "05:00",
          "close": "1380",
          "open24": false
        },
        "thursday": {
          "open": "05:00",
          "close": "1380",
          "open24": false
        },
        "tuesday": {
          "open": "05:00",
          "close": "1380",
          "open24": false
        },
        "wednesday": {
          "open": "05:00",
          "close": "1380",
          "open24": false
        }
      },
      "locationId": "01400376",
      "storeNumber": "00376",
      "divisionNumber": "014",
      "name": "Kroger Landen"
    }
  ],
  "meta": {
    "pagination": {
      "total": 0,
      "start": 0,
      "limit": 0
    },
    "warnings": ["string"]
  }
}

Provides access to the details of a specific location by using the locationId.

• locationId
  • Description: The locationId of the store.
  • Example: 01400943
  • Type: string
  • Required: true
  • Query: locationId

• 200
  • Description: OK
  • Links: None

01400943

• application/json
  • Controls Accept header.

{
  "data": {
    "address": {
      "addressLine1": "2900 W. St. Rt. 22 & 3",
      "addressLine2": "",
      "city": "Maineville",
      "county": "WARREN COUNTY",
      "state": "OH",
      "zipCode": "45039"
    },
    "chain": "KROGER",
    "phone": "5551234567",
    "departments": [
      {
        "departmentId": "01",
        "name": "Drug & General Merchandise",
        "phone": "5551234567",
        "hours": {
          "Open24": false,
          "monday": {
            "open": "05:00",
            "close": "1380",
            "open24": false
          },
          "tuesday": {
            "open": "05:00",
            "close": "1380",
            "open24": false
          },
          "wednesday": {
            "open": "05:00",
            "close": "1380",
            "open24": false
          },
          "thursday": {
            "open": "05:00",
            "close": "1380",
            "open24": false
          },
          "friday": {
            "open": "05:00",
            "close": "1380",
            "open24": false
          },
          "saturday": {
            "open": "05:00",
            "close": "1380",
            "open24": false
          },
          "sunday": {
            "open": "05:00",
            "close": "1380",
            "open24": false
          }
        }
      }
    ],
    "geolocation": {
      "latLng": "39.3110881,-84.2751167",
      "latitude": 39.3110881,
      "longitude": -84.2751167
    },
    "hours": {
      "Open24": true,
      "gmtOffset": "(UTC-05:00) Eastern Time (US Canada)",
      "timezone": "America/New_York",
      "friday": {
        "open": "05:00",
        "close": "1380",
        "open24": false
      },
      "monday": {
        "open": "05:00",
        "close": "1380",
        "open24": false
      },
      "saturday": {
        "open": "05:00",
        "close": "1380",
        "open24": false
      },
      "sunday": {
        "open": "05:00",
        "close": "1380",
        "open24": false
      },
      "thursday": {
        "open": "05:00",
        "close": "1380",
        "open24": false
      },
      "tuesday": {
        "open": "05:00",
        "close": "1380",
        "open24": false
      },
      "wednesday": {
        "open": "05:00",
        "close": "1380",
        "open24": false
      }
    },
    "locationId": "01400376",
    "storeNumber": "00376",
    "divisionNumber": "014",
    "name": "Kroger Landen"
  },
  "meta": {
    "pagination": {
      "total": 0,
      "start": 0,
      "limit": 0
    },
    "warnings": ["string"]
  }
}