---
title: "Get Worker By Handle"
method: GET
path: "/workers/{worker_handle}"
tags: ["Workers"]
---

# Get Worker By Handle

`GET /workers/{worker_handle}`

## Request

- Base URL: `https://v3.api.hypertrack.com`
- URL: `https://v3.api.hypertrack.com/workers/{worker_handle}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/hypertrack/apis/hypertrack-api/docs/workers/:worker_handle/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch the details for a worker using the worker_handle

## Path parameters

- `worker_handle` string, required

## Query parameters

- `include_deleted` boolean
- `from_time` string, date-time, nullable
- `to_time` string, date-time, nullable
- `date` string, nullable
- `include_summary` boolean
- `include_schedule` boolean
- `include_timeline` boolean

## Response `200`

Successful response

- GetWorkerTimelineResponse
  - `worker_handle` string, required: Unique customer provided identifier for a worker
  - `name` string, nullable: Name of the worker
  - `current_date` string, required: Current date in the timezone of the worker.
  - `ops_group_handle` string, required: Unique identifier for an Ops Group to which the worker belongs
  - `product_types` string[], nullable: List of product types used for worker matching during order planning
  - `device_id` string, nullable: Unique ID representing the worker's device
  - `device_info` union: Information of the Device associated with worker
    - DeviceInfo
      - `timezone` string, required: Timezone of the device
      - `os_name` string, required: Operating system running on the device
      - `device_brand` string, required: Brand of the device
      - `sdk_version` string, required: HyperTrack SDK version used on the device
      - `device_model` string, required: Model of the device
      - `network_operator` string, nullable: Network operator used by the device
      - `os_version` string, required: Operating system version on the device
      - `os_hardware_identifier` string, required: Hardware identification number for the device
      - `app_name` string, required: App name on the device
      - `app_version_string` string, nullable: App version used on the device
      - `app_version_number` string, nullable: App version number used on the device
    - unknown
  - `profile` object, nullable: Metadata associated with a worker
  - `work_status` DriverStatus1, required
    - `tracking` boolean, required: Flag indicating whether the worker is currently on work
    - `available` boolean, required: Flag indicating if the worker is available for work
  - `schedule` union[], nullable: List indicating the schedule of a worker for work assignment
    - union
      - DriverDateSchedule
        - `start_time` string, required: Start time represented by HH:mm of the worker's day schedule
        - `end_time` string, required: End time represented by HH:mm of the worker's day schedule
        - `date` string, required: Date on which the worker is available for work
        - `ops_group_handle` string, nullable: Unique identifier for an Ops Group
        - `priority` integer, nullable: Priority of schedule of a worker
      - DriverRecurringSchedule
        - `start_time` string, required: Start time represented by HH:mm of the worker's day schedule
        - `end_time` string, required: End time represented by HH:mm of the worker's day schedule
        - `day_of_week` 'SUNDAY' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY', required: Day of the week when the worker is available for work
        - `ops_group_handle` string, nullable: Unique identifier for an Ops Group
        - `priority` integer, nullable: Priority of schedule of a worker
  - `deleted` boolean, nullable: Flag indicating whether the worker was deleted
  - `created_at` string, required: Timestamp at which the worker was created
  - `home` union: Worker home
    - LocationWithoutRadiusResponse
      - `address` string, nullable: Address for the location
      - `geometry` LocationGeometryResponse, required
        - `type` string, required: Geometry type
        - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
          - unknown
    - unknown
  - `deleted_at` string, nullable: Timestamp at which the worker was deleted
  - `location` union: Last known location of the worker
    - MovementLocationResponse
      - `geometry` LocationGeometryResponse, required
        - `type` string, required: Geometry type
        - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
          - unknown
      - `accuracy` number, nullable: Accuracy in meters for the location
      - `bearing` number, nullable: Directional position in degrees for the location
      - `speed` number, nullable: Speed in meters per second at this location
      - `recorded_at` string, nullable: Timestamp associated with the last known location of the worker.
    - unknown
  - `device_status` union: Current status of the device used by the worker
    - DeviceStatus1
      - `value` string, required: Status of the worker's device - `active` `disconnected` `inactive`
      - `data` object, required: Data associated with the worker's device status - `reason`, `activity`
    - unknown
  - `unavailable_on` string[], nullable: List of dates (YYYY-MM-DD) on which the worker is not available
  - `devices` DriverDevice1[], nullable: List of devices that were linked to the worker
    - `device_id` string, required: Unique ID representing the worker's device
    - `start_time` string, required: Timestamp of when the device was linked to the worker
    - `end_time` string, nullable: Timestamp of when the device was unlinked to the worker
  - `summary` union: Summary of work for the worker
    - DriverSummary1
      - `orders` OrderSummary1, required
        - `total` integer, required: Total orders
        - `completed` integer, required: Orders completed
        - `cancelled` integer, required: Orders cancelled
        - `tracked` integer, required: Orders currently being tracked
        - `assigned` integer, required: Orders assigned
        - `completed_tasks` integer, required: Order tasks completed
      - `geotags` integer, nullable: Number of Geotags created by the worker in the specified time range.
      - `visits` integer, nullable: Number of Visits made by the worker during the specified time range.
      - `intended_track_duration` integer, required: Total duration (in seconds) for which the worker was supposed to be tracked during the specified time range.
      - `outage_duration` integer, required: Total duration (in seconds) for which the worker could not be tracked (in outage) during the specified time range.
      - `outage_distance` integer, required: Total estimated distance (in meters) covered by the worker while he/she could not be tracked during the specified time range.
      - `outage_summary` DriverOutageSummary1[], required: List of outages experienced by the worker during the specified time range.
        - `code` string, required: Code indicating the type of outage
        - `label` string, required: Text indicating the type of outage
        - `description` string, required: Text describing the outage.
        - `category` 'behavioural' | 'adversarial' | 'reachability' | 'os' | 'sporadic', required: String indicating the category of outage
        - `duration` integer, required: Sum total duration of all outages experienced with this `code` in the specified time range.
        - `distance` integer, required: Sum total (estimated) distance covered during all outages experienced with this `code` in the specified time range.
      - `tracked_duration` integer, required: Total duration (in seconds) for which the worker was actually tracked during the specified time range.
      - `tracked_distance` integer, required: Total distance (in meters) driven by the worker while the worker was actually tracked during the specified time range.
      - `avg_distance_per_visit` number, required: Average distance (in meters) driven by the worker per visit while the worker was actually tracked during the specified time range.
      - `drive_duration` integer, required: Total duration (seconds) for which the worker was driving during the specified time range.
      - `walk_duration` integer, required: Total duration (seconds) for which the worker was walking during the specified time range.
      - `stop_duration` integer, required: Total duration (seconds) for which the worker had stopped during the specified time range.
      - `order_duration` integer, required: Total duration (seconds) which the worker had spent delivering orders.
      - `visit_duration` integer, required: Total duration (seconds) which the worker had spent doing visits.
      - `geotag_duration` integer, required: Total duration (seconds) which the worker had spent creating geotags.
      - `tracking_rate` number, nullable: Average tracking rate of the worker during the specified time range.
      - `stop_count` integer, nullable: Number of stops.
      - `walk_count` integer, nullable: Number of walks.
      - `drive_count` integer, nullable: Number of drives.
      - `distance` integer, nullable: Total distance (tracked + outage) in meters covered by the worker during the specified time range.
      - `available_duration` integer, nullable: Total duration (in seconds) for which the worker was actually tracked during the specified time range.<br />__Please use the field `tracked_duration` instead.__
      - `work_duration` integer, nullable: Total duration (seconds) spent on work by the worker in the specified time range.
      - `disconnected_duration` integer, nullable: Total duration (in seconds) for which the worker was supposed to be tracked, but actually in a disconnected state.
      - `status` DriverSummaryStatus1, required
        - `intended_to_track` boolean, required: Boolean flag indicating whether worker was supposed to be tracked during the specified period.
        - `tracked` boolean, required: Boolean flag indicating whether worker was actually tracked during the specified period.
        - `worked` boolean, required: Boolean flag indicating whether worker had worked during the specified period.
        - `available` boolean, required: Boolean flag indicating whether worker was marked available during the specified period.
    - unknown
  - `location_permission` union: Last known location permission on the worker's device
    - LocationPermission1
      - `state` 'always' | 'foreground_only' | 'never' | 'location_imprecise' | 'unknown', required: State of location permission
      - `recorded_at` string, nullable: Time stamp of the last known location permission
    - unknown
  - `timeline` union[], nullable: Worker timeline events highlighting the work and relevant events during specified time range.
    - union
      - TimelineDriverActivityEvent1
        - `type` 'driver_activity_event', required: String indicating the type of timeline event.
        - `recorded_at_start` string, nullable: Timestamp indicating the beginning of the event.
        - `recorded_at_end` string, nullable: Timestamp indicating the end of the event
        - `location_start` union: Location of the device at the beginning of the event.
          - LocationGeometryModel2
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `location_end` union: Location of the device at the end of the event.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `detail` union: Details of activity ex. distance (metres), duration (seconds), steps (number)
          - ActivityDetail2
            - `steps` integer, nullable: Number of steps
            - `distance` integer, nullable: Distance in metres
            - `duration` integer, nullable: Duration in seconds
          - unknown
        - `activity` string, nullable: type of activity: drive/stop/walk
        - `marker_id` string, nullable: event id
        - `split_marker_id` string, nullable: marker id if the marker is split
        - `is_partial` boolean, required: flag indicating if the activity is trimmed.
        - `is_ongoing` boolean, required: flag indicating if the activity is ongoing.
        - `polyline` union: polyline associated with the activity
          - TimelinePolylineGeoJSON1
            - `type` string, required: type
            - `geometry` TimelinePolylineGeometry1, required
              - …
            - `properties` TimelinePolylineProperties1, required
              - …
          - unknown
        - `address` string, nullable: address associated with activity
        - `source_locations` string, nullable: source locations
        - `hex_map` PolygonHeatMap[], nullable: location heatmap for stop activity
          - `geometry` PolygonGeometry, required
            - `type` 'Polygon', required: Geometry type
            - `coordinates` array[], required: Location coordinates represented as [[[longitude, latitude], [lon, lat]...]]
              - …
          - `time_spent` number, required: time spent at the polygon
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, nullable: Unique ID of device
        - `battery_details` union: Details of battery usage during the event.
          - TimelineActivityBatteryDetails1
            - `battery_used` number, nullable: Battery percentage used during event.
            - `is_battery_usage_high` boolean, nullable: Boolean flag indicating if battery usage during the event was high.
          - unknown
      - TimelineDriverOutageEvent1
        - `type` 'driver_outage_event', required: String indicating the type of timeline event.
        - `recorded_at_start` string, nullable: Timestamp indicating the beginning of the event.
        - `recorded_at_end` string, nullable: Timestamp indicating the end of the event
        - `location_start` union: Location of the device at the beginning of the event.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `location_end` union: Location of the device at the end of the event.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `marker_id` string, nullable: unique id
        - `split_marker_id` string, nullable: marker id if the marker is split
        - `outage_code` string, required: Code indicating the type of outage
        - `outage_label` string, required: Text indicating the type of outage
        - `outage_is_user_generated` boolean, required: Flag indicating if the outage is user generated.
        - `outage_description` string, required: Text describing the outage and resolution.
        - `outage_category` 'behavioural' | 'adversarial' | 'reachability' | 'os' | 'sporadic', required: String indicating the category of outage
        - `detail` union: Details associated with outage: distance/duration etc.
          - ActivityDetail
            - `steps` integer, nullable: Number of steps
            - `distance` integer, nullable: Distance in metres
            - `duration` integer, nullable: Duration in seconds
          - unknown
        - `is_partial` boolean, required: flag indicating if the outage is partial.
        - `is_ongoing` boolean, required: flag indicating if the activity is ongoing.
        - `polyline` union: estimated polyline associated with the outage
          - TimelinePolylineGeoJSON
            - `type` string, required: type
            - `geometry` TimelinePolylineGeometry, required
              - …
            - `properties` TimelinePolylineProperties, required
              - …
          - unknown
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, nullable: Unique ID of device
      - DriverStatusUpdatedEvent2
        - `type` 'driver_status_updated', required: String indicating the type of timeline event.
        - `recorded_at` string, nullable: Timestamp when the event was recorded
        - `location` union: Location of the device when the event was recorded
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `detail` union: Details of the status update.
          - StatusDetail2
            - `actor` unknown
          - unknown
        - `tracking` boolean, nullable: Boolean flag indicating tracking status.
        - `available` boolean, nullable: Boolean flag indicating availability status.
        - `marker_id` string, nullable: unique id
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, nullable: Unique ID of device
      - TimelineGeotagEvent1
        - `type` 'geotag_event', required: String indicating the type of timeline event.
        - `recorded_at` string, nullable: Timestamp when the event was recorded
        - `location` union: Location of the device when the event was recorded
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `geotag_id` string, nullable: id of geotag
        - `address` string, nullable: Address of the device when the geotag was created.
        - `order_handle` string, nullable: Order handle associated with the geotag.
        - `metadata` object, nullable: metadata of geotag
        - `geotag_type` string, nullable: Type of geotag.
        - `deviation` integer, nullable: Deviation of geotag.
        - `expected_location` union: Expected Location.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `place_handle` string, nullable: handle of the place
        - `device_id` string, nullable: Unique ID of device
        - `accuracy` integer, nullable: Error margin of location reading associated with the geotag
        - `attachments` union[], nullable: Attachments associated with the event
          - union
            - TimelineImageAttachment1
              - …
            - TimelineNoteAttachment1
              - …
            - TimelineSignatureAttachment1
              - …
      - OrderAssignedEvent2
        - `type` 'driver_order_assigned', required: String indicating the type of timeline event.
        - `recorded_at` string, nullable: Timestamp when the event was recorded
        - `location` union: Location of the device when the event was recorded
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `order_handle` string, nullable: Order handle
        - `route_handle` string, nullable: Route handle
        - `order_type` string, nullable: Order type
        - `destination_address` string, nullable: Address of the intended order destination.
        - `destination_location` union: Intended order destination in coordinates.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `fulfillment_attempt` integer, nullable: Number of fulfillment attempts made.
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, nullable: Unique ID of device
      - OrderStartedEvent2
        - `type` 'driver_order_started', required: String indicating the type of timeline event.
        - `recorded_at` string, nullable: Timestamp when the event was recorded
        - `location` union: Location of the device when the event was recorded
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `order_handle` string, nullable: Order handle
        - `route_handle` string, nullable: Route handle
        - `order_type` string, nullable: Order type
        - `destination_address` string, nullable: Address of the intended order destination.
        - `destination_location` union: Intended order destination in coordinates.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `fulfillment_attempt` integer, nullable: Number of fulfillment attempts made.
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, nullable: Unique ID of device
      - OrderCompletedEvent2
        - `type` 'driver_order_completed', required: String indicating the type of timeline event.
        - `recorded_at` string, nullable: Timestamp when the event was recorded
        - `location` union: Location of the device when the event was recorded
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `order_handle` string, nullable: Order handle
        - `route_handle` string, nullable: Route handle
        - `order_type` string, nullable: Order type
        - `destination_address` string, nullable: Address of the intended order destination.
        - `destination_location` union: Intended order destination in coordinates.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `fulfillment_attempt` integer, nullable: Number of fulfillment attempts made.
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, nullable: Unique ID of device
        - `deviation_from_destination` integer, nullable: Distance in meters between the actual completion location to the order location
        - `completed_at_destination` boolean, nullable: Indicates whether the order was completed at destination
      - OrderCancelledEvent2
        - `type` 'driver_order_cancelled', required: String indicating the type of timeline event.
        - `recorded_at` string, nullable: Timestamp when the event was recorded
        - `location` union: Location of the device when the event was recorded
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `order_handle` string, nullable: Order handle
        - `route_handle` string, nullable: Route handle
        - `order_type` string, nullable: Order type
        - `destination_address` string, nullable: Address of the intended order destination.
        - `destination_location` union: Intended order destination in coordinates.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `fulfillment_attempt` integer, nullable: Number of fulfillment attempts made.
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, nullable: Unique ID of device
        - `cancellation_source` object, nullable: Detail about how order got cancelled
      - OrderRescheduledEvent
        - `type` 'driver_order_rescheduled', required: String indicating the type of timeline event.
        - `recorded_at` string, nullable: Timestamp when the event was recorded
        - `location` union: Location of the device when the event was recorded
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `order_handle` string, nullable: Order handle
        - `route_handle` string, nullable: Route handle
        - `order_type` string, nullable: Order type
        - `destination_address` string, nullable: Address of the intended order destination.
        - `destination_location` union: Intended order destination in coordinates.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `fulfillment_attempt` integer, nullable: Number of fulfillment attempts made.
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, nullable: Unique ID of device
      - DriverVisitEvent1
        - `type` 'driver_visit_event', required: String indicating the type of timeline event.
        - `recorded_at_start` string, nullable: Timestamp indicating the beginning of the event.
        - `recorded_at_end` string, nullable: Timestamp indicating the end of the event
        - `location_start` union: Location of the device at the beginning of the event.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `location_end` union: Location of the device at the end of the event.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `marker_id` string, nullable: unique id
        - `geofence_id` string, required: ID of the visited geofence.
        - `geofence_label` string, nullable: Name of the visited geofence.
        - `geofence_geometry` union: Geometry of the visited geofence in geojson format
          - GeofenceGeometry1
            - `type` string, required: type
            - `geometry` union, required: geometry of geofence
              - …
            - `properties` object, nullable: properties
          - unknown
        - `geofence_metadata` object, nullable: metadata of geofence
        - `address` string, nullable: Human friendly address of the visit.
        - `duration` integer, nullable: Duration of visit in seconds.
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, nullable: Unique ID of device
        - `order_handle` string, nullable: Unique handle of the order
        - `enroute_distance` integer, nullable: Distance travelled on route to the visit
        - `enroute_duration` integer, nullable: Duration spent on route to visit
      - DriverDeviceLinkedEvent2
        - `type` 'driver_device_linked_event', required: String indicating the type of timeline event.
        - `recorded_at` string, required: Timestamp indicating the beginning of the device session.
        - `location` union: Location of the device when the event was recorded
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `location_recorded_at` string, nullable: Timestamp when the location was recorded.
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, required: Unique ID of device
        - `device_info` union: Device information
          - DeviceInfo2
            - `timezone` string, required: Timezone of the device
            - `os_name` string, required: Operating system running on the device
            - `device_brand` string, required: Brand of the device
            - `sdk_version` string, required: HyperTrack SDK version used on the device
            - `device_model` string, required: Model of the device
            - `network_operator` string, nullable: Network operator used by the device
            - `os_version` string, required: Operating system version on the device
            - `os_hardware_identifier` string, required: Hardware identification number for the device
            - `app_name` string, required: App name on the device
            - `app_version_string` string, nullable: App version used on the device
            - `app_version_number` string, nullable: App version number used on the device
          - unknown
        - `former_associated_workers` unknown[], nullable: List of workers connected to this device in the last 2 days
          - unknown
      - DriverDeviceUnlinkedEvent2
        - `type` 'driver_device_unlinked_event', required: String indicating the type of timeline event.
        - `recorded_at` string, required: Timestamp indicating the end of the device session.
        - `location` union: Location of the device when the event was recorded
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `location_recorded_at` string, nullable: Timestamp when the location was recorded.
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, required: Unique ID of device
        - `device_info` union: Device information
          - DeviceInfo
            - `timezone` string, required: Timezone of the device
            - `os_name` string, required: Operating system running on the device
            - `device_brand` string, required: Brand of the device
            - `sdk_version` string, required: HyperTrack SDK version used on the device
            - `device_model` string, required: Model of the device
            - `network_operator` string, nullable: Network operator used by the device
            - `os_version` string, required: Operating system version on the device
            - `os_hardware_identifier` string, required: Hardware identification number for the device
            - `app_name` string, required: App name on the device
            - `app_version_string` string, nullable: App version used on the device
            - `app_version_number` string, nullable: App version number used on the device
          - unknown
        - `unlink_duration` integer, nullable: Duration in seconds indicating how long the worker remained unlinked from the device.
        - `unlinked_due_to_logout` boolean, nullable: Flag indicating whether the device was unlinked as a result of a logout event.
      - DeviceDisconnectedEvent2
        - `type` 'device_disconnected_event', required: String indicating the type of timeline event.
        - `recorded_at_start` string, nullable: Timestamp indicating the beginning of the event.
        - `recorded_at_end` string, nullable: Timestamp indicating the end of the event
        - `location_start` union: Location of the device at the beginning of the event.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `location_end` union: Location of the device at the end of the event.
          - LocationGeometryModel
            - `type` string, required: Geometry type.
            - `coordinates` union, required: Geo coordinates (lon, lat)
              - …
          - unknown
        - `driver_handle` string, nullable: handle of the driver
        - `worker_handle` string, nullable: handle of the worker
        - `device_id` string, required: Unique ID of device
        - `marker_id` string, nullable: unique id
        - `split_marker_id` string, nullable: marker id if the marker is split
        - `disconnected_code` string, required: Code indicating the type of event
        - `disconnected_label` string, required: Text indicating the type of event
        - `disconnected_description` string, required: Text describing the detail description.
        - `detail` union: Details associated with stats: distance/duration etc.
          - ActivityDetail
            - `steps` integer, nullable: Number of steps
            - `distance` integer, nullable: Distance in metres
            - `duration` integer, nullable: Duration in seconds
          - unknown
        - `is_partial` boolean, required: flag indicating if the outage is partial.
        - `is_ongoing` boolean, required: flag indicating if the activity is ongoing.
  - `battery` union: Information of the battery status
    - BatteryStatus1
      - `battery_percent` integer, required: Integer indicating the percent of charge on the battery.
      - `recorded_at` string, required: Timestamp of the reading
    - unknown
  - `timezone` string, nullable: Timezone of the worker

## Other responses

- `400`: Validation error
- `401`: Authentication error
- `404`: Not found

---

[API](https://skmtc.dev/hypertrack/apis/hypertrack-api.md) - [All operations](https://skmtc.dev/hypertrack/apis/hypertrack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hypertrack/apis/hypertrack-api/revisions/389326c4c9c8?raw)