---
title: "Track locations of an asset"
method: GET
path: "/skynet/asset/{id}/location/list"
tags: ["Tracking_Asset"]
---

# Track locations of an asset

`GET /skynet/asset/{id}/location/list`

## Path parameters

- `id` string, required

## Query parameters

- `key` string, 32 character alphanumeric string, required
- `start_time` integer
- `end_time` integer
- `geometry_type` 'polyline' | 'polyline6' | 'geojson' — geometry format to encode the path linking the tracked locations of the asset.
- `correction` string, mapmatch=boolean,interpolate=boolean,mode=string
- `pn` integer
- `ps` integer

## Response `200`

OK

- DtoGetLocationsResp
  - `status` string — A string indicating the state of the response. On successful responses, the value will be Ok. Indicative error messages are returned for different errors. See the [API Error Codes](#api-error-codes) section below for more information.
  - `data` DtoGetLocationsRespData
    - `list` DtoTrackLocation[] — An array of objects with details of the tracked locations of the asset. Each object represents one tracked location.
      - `accuracy` number — If available, this property returns the accuracy of the GPS information received at the tracked location. It is represented as an estimated horizontal accuracy radius, in meters, at the 68th percentile confidence level.
      - `altitude` number — If available in the GPS information, this property returns the altitude of the asset at the tracked location. It is represented as height, in meters, above the WGS84 reference ellipsoid.
      - `bearing` number — If available in the GPS information, this property returns the heading of the asset calculated from true north in clockwise direction at the tracked location. Please note that the bearing is not affected by the device orientation. The bearing will always be in the range of [0, 360).
      - `location` object — An object with the coordinates of the last tracked location.
        - `lat` number — Latitude of the tracked location of the asset.
        - `lon` number — Longitude of the tracked location of the asset.
      - `meta_data` TrackMetaDataSkynet — Specifies the custom data about the location that was added when the location was uploaded.
      - `speed` number — If available in the GPS information, this property returns the speed of the asset, in meters per second, at the tracked location.
      - `timestamp` integer — A UNIX epoch timestamp in milliseconds, representing the time at which the location was tracked.
      - `battery_level` integer — Returns the battery level of the GPS device, as a percentage, when the location was tracked. It has a minimum value of 0 and a maximum value of 100.
      - `tracking_mode` string — Internal parameter for tracking mode.
    - `page` DtoPagination — An object with pagination details of the search results. Use this object to implement pagination in your application.
      - `total` integer — An integer value indicating the total number of items available in the data set. This parameter can be used to calculate the total number of pages available.
      - `page` integer — An integer value indicating the current page number (starting at 0).
      - `size` integer — An integer value indicating the maximum number of items retrieved per page.
      - `hasmore` boolean — A boolean value indicating whether there are more items available beyond the current page.
    - `distance` number — Distance of the path, in meters, formed by connecting all tracked locations returned. Please note that distance is returned only when the mapmatch property of correction parameter is set to 1.
    - `snapped_points` object[] — An array of objects with details about the snapped points for each of the tracked locations returned for the asset. Please note that this property is returned only when the mapmatch property of correction parameter is set to 1.
      - `bearing` string — The bearing angle of the snapped point from the original tracked location, in radians. It indicates the direction of the snapped point.
      - `distance` number — The distance of the snapped point from the original tracked location, in meters.
      - `name` string — The name of the street or road of the snapped point.
      - `originalIndex` string — The index of the tracked location to which this snapped point corresponds to.
      - `location` object — The latitude and longitude coordinates of the snapped point.
        - `lat` number — Latitude of the snapped point.
        - `lon` number — Longitude of the snapped point.
    - `geojson` object — An object with geoJSON details of the route. It is returned only when the mapmatch property of the correction parameter is set to 1 and geometry_type is geojson, otherwise it is not present in the response. The contents of this object follow the [geoJSON standard](https://datatracker.ietf.org/doc/html/rfc7946).
      - `type` string — Type of the geoJSON object.
      - `geometry` object — An object with details of the geoJSON geometry of the route.
        - `type` string — Type of the geoJSON geometry.
        - `coordinates` number[] — An array of coordinates in the [longitude, latitude] format, representing the route geometry.
    - `geometry` string[] — Geometry of tracked locations in the requested format. It is returned only if the mapmatch property of the ‘correction’ parameter is set to 1.
  - `message` string — Displays the error message in case of a failed request. If the request is successful, this field is not present in the response.

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/nextbillion-ai/apis/one-spec-service.md) · [All operations](https://skmtc.net/nextbillion-ai/apis/one-spec-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextbillion-ai/one-spec-service/revisions/b647f1808dda/schema)