BYbymason
device-api

Read device location

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 first, then call this endpoint once the device has checked in.

get/v1/default/device/{id}/locate

Request

  • Base URL
    https://api.bymason.com
  • Auth
    API key in header Authorization

Path parameters

idstring uuid required

Device ID

Response

Read device location response

latitudestring

Latitude of the device's last reported location

longitudestring

Longitude of the device's last reported location

accuracystring

Accuracy radius, in meters, of the reported location

timestring date-time

Timestamp for when the device recorded this location

Example response

{
  "latitude": "37.7749",
  "longitude": "-122.4194",
  "accuracy": "20"
}

Changes

No recorded changes to this operation across all 1 revision of this API.