Location API

The Locations API provides access to all locations, chains, and departments that are owned by The Kroger Co. <br><br> ### Rate Limit The Public Locations API has a **1,600 call a day per endpoint** rate limit. For the Locations API, there are three endpoints that each have a 1,600 call per day rate limit. Since we enforce the rate limit by the number of calls the client makes to the endpoint and not individual operations, you can distribute the 1,600 calls across operations using the same endpoint as you see fit. <br><br> ### Pagination The Locations API does not support pagination. Since the response has a default limit of ten results, the response is always one page. You can extend the total number of results for the page using the `filter.limit` parameter (200 maximum). **Note**: The mile radius is set to a 10 mile default. If you extend the number of results using the `filter.limit` parameter, you may need to extend the mile radius using the `filter.radiusInMiles` parameter to get the correct number of results. <br><br> ### API Operations The Locations API supports the following operations: <br> <table> <tr> <th>Name</th> <th>Method</th> <th>Description</th> </tr> <tr> <td>Location list</td> <td>GET</td> <td>Returns a list of locations matching a given criteria.</td> </tr> <tr> <td>Location details</td> <td>GET</td> <td>Returns the details of a specific location.</td> </tr> <tr> <td>Location query</td> <td>HEAD</td> <td>Determines if a specific location exists.</td> </tr> <tr> <td>Chain list</td> <td>GET</td> <td>Returns a list of all chains owned by The Kroger Co.</td> </tr> <tr> <td>Chain details</td> <td>GET</td> <td>Returns the details of a specific chain.</td> </tr> <tr> <td>Chain query</td> <td>HEAD</td> <td>Determines if a specific chain exists.</td> </tr> <tr> <td>Department list</td> <td>GET</td> <td>Returns a list of all departments for a specific location.</td> </tr> <tr> <td>Department details</td> <td>GET</td> <td>Returns the details of a specific department.</td> </tr> <tr> <td>Department query</td> <td>HEAD</td> <td>Determines if a specific department exists.</td> </tr> </table>