/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
: Addsaddress
field 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_status
false
: 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_ts
in 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 withname
andnumber
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