---
title: "Get Device Positions"
method: GET
path: "/v1/locate/devices/{deviceId}/positions"
tags: ["Device Locator"]
---

# Get Device Positions

`GET /v1/locate/devices/{deviceId}/positions`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/locate/devices/{deviceId}/positions`
- Auth: HTTP bearer

Get positions of a specific device (maximum of last 7 days).
![Creative Commons License](https://mirrors.creativecommons.org/presskit/buttons/80x15/svg/by-sa.svg) [OpenCelliD Project](https://opencellid.org/) is licensed under a [Creative Commons Attribution-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-sa/4.0/)

## Path parameters

- `deviceId` string, required

## Query parameters

- `page` integer
- `sort` string[]
- `source` 'GPS' | 'CellTower'
- `startDateTime` string
- `endDateTime` string
- `pageSize` integer
- `mode` 'ALL' | 'SUMMARY'

## Response `200`

OK

- GetResponseschema9: Get positions of a specific device.
  - `page` number, required: The current page number of the positions.
  - `pageAmount` number, required: The total amount of pages needed to show all positions.
  - `coordinates` GetResponseschema9CoordinatesInner[], required: Positions of the device
    - `coordinate` number[], required: Coordinates of the specific position, in the following format [long, lat]
    - `sampleTime` string, date-time, required: Sample time of the position
    - `source` 'GPS' | 'CellTower', required: Source of the Position
    - `metadata` object: Metadata of the Position

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)