---
title: "Device geolocation history"
method: GET
path: "/v2/device/{id}/geolocation/history"
tags: ["Geolocation"]
---

# Device geolocation history

`GET /v2/device/{id}/geolocation/history`

## Request

- Base URL: `https://app.ninjarmm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ninjarmm.com/v2/device/{id}/geolocation/history`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sessionKey`
- TypeScript: <https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/docs/v2/device/:id/geolocation/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns paginated geolocation history for a mobile device. Defaults to the last 7 days; the time window cannot exceed 7 days.

## Path parameters

- `id` integer, required

## Query parameters

- `after` number, double
- `before` number, double
- `pageSize` integer
- `cursor` string

## Response `200`

Geolocation history

- object
  - `results` object[]: Geolocation records
    - `latitude` number, double: Device latitude
    - `longitude` number, double: Device longitude
    - `timestamp` number, double: Location timestamp, epoch seconds with millisecond precision
  - `cursor` object
    - `name` string
    - `offset` integer
    - `count` integer
    - `expires` number, double

## Other responses

- `400`: Invalid parameters or cursor
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Device not found or not a mobile device
- `429`: Rate limit exceeded

## Changes

- **2026-10-01** `5932b93aea2a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/changes/v2/device/:id/geolocation/history/get.md)

---

[API](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0.md) - [All operations](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/revisions/5ce571d1bb71?raw)