---
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`

## Request

- Base URL: `https://portal-apis.telematicssdk.com/realtime`
- URL: `https://portal-apis.telematicssdk.com/realtime/api/v1/devices/{device_token}/tracks`
- Auth: HTTP bearer

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.dev/damoov/apis/real-time-data-http-api.md) - [All operations](https://skmtc.dev/damoov/apis/real-time-data-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/damoov/apis/real-time-data-http-api/revisions/417eb18d1916?raw)