List tracked assets on the map

Request#

GET /api/v1/dashboard/gps-assets

Requires reports:read, assets:read, and assets:tracking. See dashboard report permissions.

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

Query parameters#

page integer Optional

The page of results to return. Starts at 1; defaults to 1.

per_page integer Optional

The maximum number of results per page. Accepts 1–100; defaults to 25.

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/dashboard/gps-assets?per_page=50" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK.

{
  "data": [
    {
      "id": 123,
      "asset_tag": "LAP-042",
      "manufacturer": "Lenovo",
      "model": "ThinkPad T14",
      "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,
      "connected": true
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 1
  },
  "links": {
    "next": null,
    "prev": null
  }
}

Behavior and constraints#

Lists every asset with a GPS tracker, newest asset first, with the same position values as an asset’s GPS position. Position values are null until the tracker reports its first fix. GPS tracking must be enabled for the organization; otherwise the request returns 403. See GPS tracking in the user manual.

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. 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.