---
title: "Get tracking data"
method: GET
path: "/tracking/{tracking_id}"
tags: ["Tracking"]
---

# Get tracking data

`GET /tracking/{tracking_id}`

## Request

- Base URL: `https://v3.api.hypertrack.com`
- URL: `https://v3.api.hypertrack.com/tracking/{tracking_id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/hypertrack/apis/hypertrack-api/docs/tracking/:tracking_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch tracking data for a tracking id.

## Path parameters

- `tracking_id` string, required

## Query parameters

- `include_inferences` boolean, nullable

## Response `200`

Successful response

- TrackingResponse
  - `order` TrackingOrder, required
    - `order_handle` string, required: Identifier of the order
    - `route_handle` string, required: Route identifier
    - `scheduled_at` string, nullable: Scheduled arrival of the order
    - `planned_at` string, nullable: Time when the order was planned
    - `assigned_at` string, nullable: Time when order was assigned to a driver
    - `started_at` string, nullable: Time when the order started
    - `arrived_at` string, nullable: Time when the driver arrived at destination
    - `exited_at` string, nullable: Time when driver exited from destination
    - `completed_at` string, nullable: Time when order was completed
    - `cancelled_at` string, nullable: Time when order was cancelled
    - `start_address` string, nullable: Start address from where order started at
    - `destination` union: Destination of the order
      - LocationResponse
        - `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
        - `radius` integer, nullable: Radius around POINT geometry to define the bounds of this location
        - `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
      - unknown
    - `summary` union: Summary of the order
      - TripSummary
        - `distance` integer, required: Distance travelled by driver
        - `duration` integer, required: Time spent by the driver on order
        - `locations` TimeSeriesLocation[], required: Locations on route taken by the driver
          - `lat` number, required: Latitude of the location
          - `lon` number, required: Longitude of the driver
          - `timestamp` string, required: Time when location was recorded
      - unknown
    - `estimate` union: Estimate for the order
      - EstimateResponse
        - `start_by` string, required: Time when driver should start the order
        - `distance` integer, required: Estimated distance to be travelled by driver
        - `duration` integer, required: Estimated time needed to reach destination
        - `polyline` LocationGeometryResponse, required
          - `type` string, required: Geometry type
          - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
            - unknown
        - `start_location` LocationGeometryResponse, required
          - `type` string, required: Geometry type
          - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
            - unknown
        - `end_location` LocationGeometryResponse, required
          - `type` string, required: Geometry type
          - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
            - unknown
        - `arrive_at` string, required: Time when driver should reach the destination
      - unknown
    - `status` string, nullable: Status of the order
    - `attachments` object[], nullable: Attachments for this order
    - `metadata` object, nullable: Metadata associated with this order
    - `timezone` string, nullable: Timezone of the order
  - `driver` TrackingDriver, required
    - `driver_handle` string, required: Driver handle
    - `device_id` string, required: Device id of the device of driver
    - `device_model` string, required: Model of the device of driver
    - `name` string, required: Name of the driver
    - `location` DriverLocation1, required
      - `geometry` LocationGeometryResponse, required
        - `type` string, required: Geometry type
        - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
          - unknown
      - `bearing` number, required: Bearing of the driver
      - `accuracy` number, required: Accuracy of location the driver
      - `speed` number, required: Speed of the driver
      - `recorded_at` string, required: Time when the location of the driver was recorded
    - `status` string, required: Status of the driver
  - `inferences` TrackingInferences, required
    - `destination_inferences` TrackingDestinationInferences, required
      - `locations` InferenceLocation[], required
        - `geometry` LocationGeometryResponse, required
          - `type` string, required: Geometry type
          - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
            - unknown
        - `inferences` TrackingLocationScore[], required
          - `type` 'parking' | 'checkin', required
          - `count` integer, required
          - `score` number, required
      - `service_area` LocationGeometryResponse[], required
        - `type` string, required: Geometry type
        - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
          - unknown
      - `geofences` TrackingInferredGeofence[], required
        - `inclusivity` string, required
        - `geometry` LocationGeometryResponse, required
          - `type` string, required: Geometry type
          - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
            - unknown
    - `order_inferences` TrackingOrderInferences, required
      - `parking` LocationGeometryResponse[], required
        - `type` string, required: Geometry type
        - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
          - unknown
      - `checkin` LocationGeometryResponse[], required
        - `type` string, required: Geometry type
        - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
          - unknown

## Other responses

- `400`: Validation 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)