---
title: "Get Worker History"
method: GET
path: "/workers/{worker_handle}/history"
tags: ["Workers"]
deprecated: true
---

# Get Worker History

`GET /workers/{worker_handle}/history`

## Request

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

> **Deprecated.**

Generate and fetch the worker history for the provided time range

## Path parameters

- `worker_handle` string, required

## Query parameters

- `from_time` string, date-time, nullable
- `to_time` string, date-time, nullable
- `date` string, nullable

## Response `200`

Successful response

- GetWorkerHistoryResponse
  - `worker_handle` string, required: Unique customer provided identifier for a worker
  - `locations` LineStringLocation1, required
    - `type` string, required: Type of location object
    - `coordinates` array[], required: Array of coordinates and the recorded_at timestamp
      - unknown[]
        - unknown
  - `markers` object[], required: List of markers summarising the history of the worker
  - `started_at` string, required: Time from where the history is requested from
  - `completed_at` string, required: Time to where the history is requested to
  - `distance` integer, required: Distance tracked during the duration of history
  - `duration` integer, required: Duration tracked during the duration of history
  - `steps` integer, required: Number of steps taken by worker during the duration of history

## 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)