/getaccounts which returns complete member profiles.
REQUEST
Locate specific members by UID or username:Object with member UIDs or usernames as keys. Each key maps to an empty object
{}.Use this to locate specific members.Example: {"worker1uid": {}, "worker2@company.com": {}}Array of team numbers (integers) to locate all members in those teams.Alternative to
accounts for team-based location retrieval.- If array is provided with team numbers: Returns members from those specific teams
- If array is empty or not provided: Returns all company employees (if you have a company)
[1, 2, 5]Include reverse-geocoded address for each location.
true: Addsaddressfield with human-readable addressfalse: No address field (faster response)
Include detailed device and connection information.
true: Adds device fields likeconnection_type,android_id,loc_gps_on,tracking_statusfalse: Basic location data only
Optional signal command to send to devices.
"ping": Sends a ping signal to all devices, requesting them to update their location immediately- Devices that are online with internet connection will respond with fresh location data
signal_tsin response shows when device last received a ping
RESPONSE
Status code.
0 indicates success.Array of location objects, one per member. Each contains:Core Identity:
uid(string): Member unique identifierusr(string): Username/emailname(string): Full nameemail(string): Email addressphone(string): Phone numberteams(array): Array of team objects withnameandnumber
lat(double): Latitudelng(double): Longitudets(long): Location timestamp in milliseconds (Unix epoch)acc(integer): GPS accuracy in metersdir(integer): Direction heading (0-360 degrees)spd(double): Speed (meters per second)elv(integer): Elevation/altitudebat(integer): Battery level percentage (0-100)
address(string): Reverse-geocoded street address
connection_type(integer): Device internet connection typeandroid_id(string): Android device identifierloc_gps_on(boolean): GPS enabled on deviceloc_net_on(boolean): Network location enabledtracking_status(boolean): HelloTracks tracking enabledsignal_ts(long): Timestamp of last ping signal received
Use Cases
Fleet Tracking: Monitor real-time positions of all field workers to optimize dispatching and provide customer ETAs. Team Location: View locations of specific team members working in a particular zone or on specific projects. Live Map Display: Build a live map dashboard showing current positions of all active workers. Ping for Updates: Request immediate location updates from devices by adding"signal": "ping" parameter.
Examples
Timestamps: All timestamps are in milliseconds since Unix epoch (January 1, 1970 UTC). This is the standard Java/JavaScript timestamp format.
Ping Signal: When using
"signal": "ping", only devices that are currently online with internet connectivity will respond with updated location. Offline devices will not update.Performance: For frequent location polling, use this endpoint instead of
/getaccounts as it returns a lighter payload focused on location data.Related Endpoints
- Get Members - Full member profiles with all properties
- Get Tracks - Historical GPS track data
- Member Object - Complete member data structure