---
title: "Get Device Tracks"
method: GET
path: "/api/v1/devices/{device_token}/tracks"
tags: ["Real-time Data"]
---

# Get Device Tracks

`GET /api/v1/devices/{device_token}/tracks`

Get current/latest tracking data for a device

## Path parameters

- `device_token` string, required

## Query parameters

- `units` string — Unit system: metric (km/h, m) or imperial (mph, ft)
- `timezone` string — Timezone for timestamps (e.g., 'UTC', 'America/New_York')
- `date_format` string — Date format: unix, iso, or localized

## Response `200`

Successful Response

- TrackingData — Tracking data response model
  - `device_token` string, required — UUID of the device
  - `tracks` object, required — Track data grouped by TrackToken (UUID)
  - `total_points` integer, required — Total number of coordinate points
  - `date_range` object, required — Date range of the data
  - `current_track_token` string, nullable — Currently active track token
  - `last_updated` string, date-time, nullable — Last update timestamp
  - `trip_started_at` string, date-time, nullable — When current trip started
  - `is_current_trip_only` boolean — Indicates this contains only current trip data

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/damoov/apis/user-service.md) · [All operations](https://skmtc.net/damoov/apis/user-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/damoov/user-service/revisions/1a5db2e2251f/schema)