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

# Get Device Position

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

## Request

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

**Parameters:**
- **device_token**: UUID of the device
- **units**: Unit system (metric/imperial) for speed/distance conversion
- **timezone**: Timezone for timestamp formatting
- **date_format**: Format for timestamps (unix/iso/localized)

**Returns:**
- Device position with source indication (is_from_cache field)

**Example Usage:**
```
GET /devices/e4855fba-0d7e-4dbd-baad-aae9d0b90c15/position
GET /devices/e4855fba-0d7e-4dbd-baad-aae9d0b90c15/position?units=imperial&date_format=iso
```

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

- DevicePosition: Device position response model
  - `device_token` string, required: UUID of the device
  - `accuracy` number, required: GPS accuracy in meters
  - `latitude` number, required: Latitude coordinate
  - `longitude` number, required: Longitude coordinate
  - `speed` number, required: Speed in km/h or m/s
  - `timestamp` integer, required: Unix timestamp in seconds
  - `last_updated` string, date-time, required: Last update time
  - `is_from_cache` boolean: Whether data came from cache (MongoDB) vs real-time (Redis)

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