---
title: "Read device location"
method: GET
path: "/v1/default/device/{id}/locate"
tags: ["device-api"]
---

# Read device location

`GET /v1/default/device/{id}/locate`

## Request

- Base URL: `https://api.bymason.com`
- URL: `https://api.bymason.com/v1/default/device/{id}/locate`
- Auth: API key in header `Authorization`

Fetches the last known geographic location reported by a device. This
returns the most recent location on file; it does not query the device directly.
To request a fresh location, send a [Locate Action](#operation/device-locate)
first, then call this endpoint once the device has checked in.

## Path parameters

- `id` string, uuid, required

## Response `200`

Read device location response

- DeviceLocation: The last known geographic location reported by a device.
  - `latitude` string: Latitude of the device's last reported location
  - `longitude` string: Longitude of the device's last reported location
  - `accuracy` string: Accuracy radius, in meters, of the reported location
  - `time` string, date-time: Timestamp for when the device recorded this location

## Other responses

- `400`: Bad request
- `404`: Resource(s) not found
- `500`: Internal server error

---

[API](https://skmtc.dev/bymason/apis/mason-platform-apis-docs.md) - [All operations](https://skmtc.dev/bymason/apis/mason-platform-apis-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/bymason/apis/mason-platform-apis-docs/revisions/365b123b04d4?raw)