Skip to main content
{
"status_label_ts":1668530288557,
"role":"admin",
"color":"#22c328",
"route_start_lng":9.56416,
"route_start_time":-1,
"timezone":"Europe/Vienna",
"timestamps":{
  "created":1334218991087,
  "login":1699521431189,
  "signal":1699521425482,
  "tracking":1699259010889
},
"language":"en",
"vehicle_capacity":0,
"type":"person",
"states":{
  "login_status":false,
  "location_services":true,
  "battery_save":false,
  "tracking_status":true,
  "off_trackrecording":false,
  "location_permission":true,
  "moving":"halted",
  "off_gps_stationary":false
},
"uid":"je7oc8",
"route_start_lat":47.2574,
"id":"je7oc8",
"unit_date":"dd.MM.yyyy",
"email":"mario.bertschler@gmx.at",
"email_verified":true,
"battery_level":89,
"teams":[
  1
],
"battery_plugged":false,
"portrait":"https://hellotracks.com/img/accounts/je7oc8/portrait_1699259050905_thumb.jpg",
"twofactor_auth_enabled":false,
"google_calendar":false,
"unit_time":"12",
"status_label":" Vacation",
"route_end_lat":47.2574,
"unit_distance":"SI",
"phone_verified":true,
"travel_mode":"car",
"phone":"+436608277299",
"working_hours":{
  "sunday":{
     "start":300,
     "end":2130
  },
  "saturday":{
     "start":300,
     "end":2130
  },
  "tuesday":{
     "start":300,
     "end":2130
  },
  "wednesday":{
     "start":300,
     "end":2130
  },
  "thursday":{
     "start":0,
     "end":0
  },
  "friday":{
     "start":300,
     "end":2130
  },
  "source":"individual",
  "monday":{
     "start":300,
     "end":2130
  }
},
"name":"D Bernoulli",
"location":{
  "head":243,
  "lng":9.60521,
  "accuracy":96,
  "lat":47.24949,
  "speed":2,
  "ts":1699472445000
},
"device":{
  "mode":1,
  "diagnostics_path":"/img/attachments/cubt5w/diagnostics/394e496e-760d-4342-b95f-ec4d4c135d15.json",
  "os":"Android 14",
  "app_version":245,
  "model":"Pixel 7a",
  "id":"31e85970b571139d",
  "app_launches":3,
  "app_version_name":"7.3.3",
  "manufacturer":"Google"
},
"username":"daniel.bernoulli.ts",
"route_end_lng":9.56416
}
The Member object represents a person/user in your HelloTracks organization. This includes field workers, dispatchers, and administrators.
Creating Members: Use /createaccount endpoint
Editing Members: Use /editaccount endpoint
Getting Members: Use /getaccounts endpoint

Core Properties

PropertyTypeR/WDescription
idTEXTRUnique identifier (same as uid)
uidTEXTRThe user’s unique identifier
usernameTEXTRThe username/email address for login
nameTEXTRWThe display name of the user
emailTEXTRWThe user’s email address
email_verifiedBOOLEANRWhether the user’s email has been verified
phoneTEXTRWThe user’s phone number
phone_verifiedBOOLEANRWhether the user’s phone number has been verified
typeTEXTRAlways “person” for member objects
colorTEXTRWDesignated color code in hexadecimal format (e.g., “#22c328”)
portraitTEXTRURL to the user’s portrait/avatar image thumbnail
portrait_tsLONGRTimestamp when portrait was last updated

Role & Permissions

PropertyTypeR/WDescription
roleTEXTRWUser role: “worker”, “operator” (dispatcher), or “admin” (superuser)
active_statusTEXTRAccount status if not normal (e.g., suspended, deactivated)
teamsARRAYRArray of team IDs (numbers) the user belongs to
scim_dataTEXTRWSCIM provisioning data (for enterprise SSO integrations)

Location & Tracking

PropertyTypeR/WDescription
locationOBJECTRCurrent location object (see structure below)
statesOBJECTRVarious state indicators (see structure below)
timestampsOBJECTRImportant timestamps (see structure below)
battery_levelINTEGERRCurrent device battery level (0-100 percentage)
battery_pluggedBOOLEANRWhether device is plugged into power source
status_labelTEXTRWCustom status label (e.g., “On Break”, “Vacation”)
status_label_tsLONGRTimestamp when status label was last updated
current_trip_idTEXTRID of currently active trip (if any)

Route & Navigation

PropertyTypeR/WDescription
route_start_latDOUBLERWLatitude of route start location
route_start_lngDOUBLERWLongitude of route start location
route_end_latDOUBLERWLatitude of route end location
route_end_lngDOUBLERWLongitude of route end location
route_start_timeINTEGERRWRoute start time (HHMM format), -1 if using team default
travel_modeTEXTRWMode of travel: “car”, “bicycle”, “pedestrian”, “truck”, “van”, “motorcycle”
vehicle_capacityINTEGERRWCapacity of vehicle for pickup/dropoff calculations

Working Hours & Availability

PropertyTypeR/WDescription
working_hoursOBJECTRWorking hours for each day of week (see structure below)
ignore_working_hours_until_tsLONGRTimestamp until which working hours are ignored

Localization & Preferences

PropertyTypeR/WDescription
languageTEXTRWLanguage preference (ISO code, e.g., “en”, “de”, “es”)
timezoneTEXTRWTimezone (region/city format, e.g., “Europe/Vienna”, “America/New_York”)
unit_distanceTEXTRWDistance unit system: “SI” (metric) or “US” (imperial)
unit_timeTEXTRWTime format: “12” or “24” hour
unit_dateTEXTRWDate format pattern (e.g., “dd.MM.yyyy”, “MM/dd/yyyy”)

Skills & Capabilities

PropertyTypeR/WDescription
skillsARRAYRWArray of skill tags for job matching (JSON array string)
expertiseTEXTRWExpertise level or description

Device Information

PropertyTypeR/WDescription
deviceOBJECTRDevice details object (see structure below)

Security & Authentication

PropertyTypeR/WDescription
twofactor_auth_enabledBOOLEANRWhether two-factor authentication is enabled
google_calendarBOOLEANRWWhether Google Calendar integration is enabled

Nested Object Structures

location Object

FieldTypeDescription
latDOUBLELatitude
lngDOUBLELongitude
tsLONGTimestamp of location fix (milliseconds)
headINTEGERHeading/bearing in degrees (0-360)
accuracyINTEGERLocation accuracy in meters
speedINTEGERSpeed in m/s

states Object

FieldTypeDescription
movingTEXTMovement state: “halted”, “idling”, “ontheway”, “offduty”
tracking_statusBOOLEANWhether tracking is currently active
location_servicesBOOLEANWhether device location services are enabled
login_statusBOOLEANWhether user is currently logged in to app
battery_saveBOOLEANWhether battery save mode is active
off_trackrecordingBOOLEANWhether track recording is disabled
ignoring_battery_optimizationBOOLEANWhether app ignores battery optimization
off_gps_stationaryBOOLEANWhether GPS is off while stationary
location_permissionBOOLEANWhether app has location permissions

timestamps Object

FieldTypeDescription
signalLONGLast signal/heartbeat timestamp
createdLONGAccount creation timestamp
loginLONGLast login status change timestamp
syncLONGLast app sync timestamp
trackingLONGLast tracking status change timestamp
suspendedLONGDevice suspension timestamp (if applicable)
recoveredLONGDevice recovery timestamp (if applicable)

device Object

FieldTypeDescription
modelTEXTDevice model (e.g., “Pixel 7a”)
manufacturerTEXTDevice manufacturer (e.g., “Google”)
osTEXTOperating system (e.g., “Android 14”, “iOS 17”)
app_launchesINTEGERNumber of times app has been launched
app_versionINTEGERApp version number (internal)
app_version_nameTEXTApp version name (e.g., “7.3.3”)
idTEXTUnique device identifier
modeINTEGERDevice mode (tracking configuration)
diagnostics_pathTEXTPath to diagnostics file (if available)
nameTEXTCustom device name (if set)

working_hours Object

Each day (monday-sunday) contains:
FieldTypeDescription
startINTEGERStart time in minutes from midnight (e.g., 480 = 8:00 AM)
endINTEGEREnd time in minutes from midnight (e.g., 1020 = 5:00 PM)
sourceTEXT”individual” or “team” indicating source of hours
Example:
{
  "monday": { "start": 480, "end": 1020 },
  "tuesday": { "start": 480, "end": 1020 },
  "wednesday": { "start": 0, "end": 0 },
  "source": "individual"
}
Note: start: 0 and end: 0 indicates a day off
{
"status_label_ts":1668530288557,
"role":"admin",
"color":"#22c328",
"route_start_lng":9.56416,
"route_start_time":-1,
"timezone":"Europe/Vienna",
"timestamps":{
  "created":1334218991087,
  "login":1699521431189,
  "signal":1699521425482,
  "tracking":1699259010889
},
"language":"en",
"vehicle_capacity":0,
"type":"person",
"states":{
  "login_status":false,
  "location_services":true,
  "battery_save":false,
  "tracking_status":true,
  "off_trackrecording":false,
  "location_permission":true,
  "moving":"halted",
  "off_gps_stationary":false
},
"uid":"je7oc8",
"route_start_lat":47.2574,
"id":"je7oc8",
"unit_date":"dd.MM.yyyy",
"email":"mario.bertschler@gmx.at",
"email_verified":true,
"battery_level":89,
"teams":[
  1
],
"battery_plugged":false,
"portrait":"https://hellotracks.com/img/accounts/je7oc8/portrait_1699259050905_thumb.jpg",
"twofactor_auth_enabled":false,
"google_calendar":false,
"unit_time":"12",
"status_label":" Vacation",
"route_end_lat":47.2574,
"unit_distance":"SI",
"phone_verified":true,
"travel_mode":"car",
"phone":"+436608277299",
"working_hours":{
  "sunday":{
     "start":300,
     "end":2130
  },
  "saturday":{
     "start":300,
     "end":2130
  },
  "tuesday":{
     "start":300,
     "end":2130
  },
  "wednesday":{
     "start":300,
     "end":2130
  },
  "thursday":{
     "start":0,
     "end":0
  },
  "friday":{
     "start":300,
     "end":2130
  },
  "source":"individual",
  "monday":{
     "start":300,
     "end":2130
  }
},
"name":"D Bernoulli",
"location":{
  "head":243,
  "lng":9.60521,
  "accuracy":96,
  "lat":47.24949,
  "speed":2,
  "ts":1699472445000
},
"device":{
  "mode":1,
  "diagnostics_path":"/img/attachments/cubt5w/diagnostics/394e496e-760d-4342-b95f-ec4d4c135d15.json",
  "os":"Android 14",
  "app_version":245,
  "model":"Pixel 7a",
  "id":"31e85970b571139d",
  "app_launches":3,
  "app_version_name":"7.3.3",
  "manufacturer":"Google"
},
"username":"daniel.bernoulli.ts",
"route_end_lng":9.56416
}
I