Get Locations

The Volt Locations API retrieves a list of store locations and associated information, including store address, hours, hierarchy (region, market, etc), and calendar events.

Endpoints

GET
/admin/v1/locations

Request Parameters

ParameterDescriptionData Type
sortThe way data being returned is sorted.String
LocationNumberReturns information about a specific location.String
UpdatedDateReturns information based on the UpdatedDate parameter.String($Date-time)
LimitLimits the number of locations that are returned. Used with Offset to retrieve in batches.Integer($int32)
OffsetIf not specified it will grab the first “limited amount”. If you want to get the next batch you will need to offset by that value.Integer($int32)

Response Details

ParameterDescription
totalCountReturns the total number of events in the response for this employee.
resultsAn Array containing details of the events returned in the response.
idAn ID associated with the event. This is automatically created by the system and can be used if you want to get details of a specific event (optional).
employeeNumberThe employee number of the employee associated with the event.
numberThe store number associated with the event.
retailerThe name of the retailer associated with the event.
latThe latitude coordinate of the event location (optional).
LongThe latitude coordinate of the event location (optional).
invoicedDenotes whether or not the event is invoiced (true/false).
metersFromLocationProvides the distance from the store where the user checked in or out on the app.
utilizedBadgeIndicates whether or not the employee checked in/out with their badge.
manuallyAlteredTimeIndicates if the event time has been manually altered (true/false).
reportedTimeThe event time reported, in UTC Date/time format.
systemTimeThe event time recorded by the system, in UTC Date/time format.
offsetCan be used to retrieve events in batches. If not specified it will grab the first “limited amount”. If you want to get the next batch you will need to offset by that value.
limitLimits the number of events that are returned. Used with Offset to retrieve in batches.
sortByReturns the column name data is being sorted by, based on sort requested.
sortAscendingIndicate if the returned events are sorted ascending (true/false). Prefix with a minus in the sort parameter for descending.

For any technical or support questions, please contact us.

Please note: Provider organizations are responsible for providing support for their employees. Walmart Volt only provides support to Provider Administrators and the Field Group’s technical team, enabling each company to properly support the field reps.



Disclaimer

Your use of the API documentation is at your own discretion and risk. To the maximum extent permitted by law, the APIs, documentation and all related software, components, and support are provided by Walmart on an "as-is" and "as available" basis without any warranties of any kind, and Walmart expressly disclaims any and all express and implied warranties, including, but not limited to, warranties of merchantability, fitness for a particular purpose, title, noninfringement, non-interference, and warranties arising from a course of dealing. You acknowledge that Walmart does not warrant that the APIs will be uninterrupted, timely, secure, or error-free. Walmart may modify and delete API documentation in its sole discretion and without notice.

In no event shall Walmart be liable to you or any third parties for any damages whatsoever, including, without limitation, those resulting from loss of use, damage to your computer system, loss of data or profits, or any liability arising out of or in connection with the use of the APIs, documentation, software, components, or support.





©️Walmart | All Rights Reserved