↑ ↓ to navigate · ↵ to open See all results
GET /api/v1/dashboard/gps-assets

List tracked assets on the map

List GPS-tracked assets with their latest positions.

Last updated

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

JSON
{
  "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,
      "has_battery": true,
      "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, including has_battery. 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.