/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
-
pageinteger Optional - The page of results to return. Starts at
1; defaults to1. -
per_pageinteger Optional - The maximum number of results per page. Accepts
1–100; defaults to25.
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,
"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.