Get an asset’s GPS position

Request#

GET /api/v1/gps/assets/{asset}

Requires assets:read and assets:tracking. See token permissions. Every listed permission is required for this endpoint.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.

asset is the numeric asset ID in your token’s organization. The asset must have a GPS tracker.

Query parameters#

This endpoint does not use query parameters.

Example#

Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example record and option IDs with values from your organization.

curl --request GET "https://my.assetcenter.app/api/v1/gps/assets/123" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK.

{
  "data": {
    "asset_id": 123,
    "live": {
      "lat": 47.6062,
      "lng": -122.3321,
      "address": "400 Pine St, Seattle, WA",
      "fix_at": "2026-10-02T15:58:00.000000Z",
      "speed_mph": 0,
      "battery_percent": 86,
      "course": 90,
      "connected": true
    },
    "available_from": "2026-09-29T16:00:00.000000Z",
    "has_history": true
  }
}

Behavior and constraints#

live is the tracker’s most recent fix, or null before the first one. Coordinates are decimal degrees; fix_at is when the position was recorded, in UTC. speed_mph is in miles per hour, course is the heading in degrees, and battery_percent may be null when the tracker doesn’t report it. connected is true while the tracker has checked in recently. available_from is when the current tracker was attached to the asset, and has_history shows whether any position history exists for the history endpoint.

GPS tracking must be enabled for the organization; otherwise the request returns 403. See GPS tracking in the user manual. An asset without a tracker, or in another organization, returns 404. Tracker device identifiers are never returned.

Errors#

401 means the token is missing, expired, revoked, or not a customer API token. 403 means a required permission or administrator access is missing. 404 means the asset is unavailable or has no tracker. 422 identifies invalid or unsupported input; inspect the errors object when present. 429 means a rate limit was reached. See error handling and rate limits.