---
title: "Upload track info"
method: POST
path: "/skynet/asset/{id}/track"
tags: ["Tracking_Asset"]
---

# Upload track info

`POST /skynet/asset/{id}/track`

## Path parameters

- `id` string, required

## Query parameters

- `key` string, 32 character alphanumeric string, required

## Request body

- DtoUploadTrackReq
  - `locations` object, required — An array of objects to collect the location tracking information for an asset. Each object must correspond to details of only one location.
    - `accuracy` number — Use this parameter to provide the accuracy of the GPS information at the tracked location. It is the estimated horizontal accuracy radius, in meters.
    - `altitude` number — Use this parameter to provide the altitude, in meters, of the asset at the tracked location.
    - `bearing` number — Use this parameter to provide the heading of the asset, in radians, calculated from true north in clockwise direction. This should always be in the range of [0, 360).
    - `location` object, required — An object to collect the coordinate details of the tracked location. Please note this field is mandatory when uploading locations for an asset.
      - `lat` number, required — Latitude of the tracked location of the asset.
      - `lon` number, required — Longitude of the tracked location of the asset.
    - `speed` number — Use this parameter to provide the speed of the asset, in meters per second, at the tracked location.
    - `timestamp` integer, required — Use this parameter to provide the time, expressed as UNIX epoch timestamp in milliseconds, when the location was tracked. Please note this field is mandatory when uploading locations for an asset.
    - `meta_data` object — Use this object to add any custom data about the location that is being uploaded. Recommended to use the key:value format for adding the desired information. Please note that the maximum size of meta_data object should not exceed 65Kb.
    - `battery_level` integer — Use this parameter to provide the battery level of the GPS device, as a percentage, when the location is tracked. It should have a minimum value of 0 and a maximum value of 100.
    - `tracking_mode` string — NB tracking mode.
  - `device_id` string, required — ID of the device used to upload the tracking information of the asset. Please note that the device_id used here must already be linked to the asset. Use the *Bind Device to Asset* method to link a device with your asset.

## Response `200`

OK

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

## 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/versions/b647f1808dda/schema)