---
title: "Get an Asset"
method: GET
path: "/skynet/asset/{id}"
tags: ["Tracking_Asset"]
---

# Get an Asset

`GET /skynet/asset/{id}`

## Path parameters

- `id` string, required

## Query parameters

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

## Response `200`

OK

- DtoGetAssetResp
  - `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` object — An object containing the information about the asset returned.
    - `asset` DtoAssetDetails — An object with details of the asset properties.
      - `id` string — ID of the asset. This is the same ID that was generated/provided at the time of creating the asset.
      - `device_id` string — ID of the device that is linked to this asset. Please note that there can be multiple device_id linked to a single asset. An empty response is returned if no devices are linked to the asset. User can link a device to an asset using the *Bind Asset to Device* method.
      - `state` string — State of the asset. It will be "active" when the asset is in use or available for use, and it will be "deleted" in case the asset has been deleted.
      - `name` string — Name of the asset. The value would be the same as that provided for the name parameter at the time of creating or updating the asset.
      - `description` string — Description of the asset. The value would be the same as that provided for the description parameter at the time of creating or updating the asset.
      - `meta_data` MetaData — Any valid json object data. Can be used to save customized data. Max size is 65kb.
      - `created_at` integer — A UNIX epoch timestamp in seconds representing the time at which the asset was created.
      - `updated_at` integer — A UNIX epoch timestamp in seconds representing the time at which the asset was last updated.
      - `tracked_at` integer — A UNIX epoch timestamp in seconds representing the last time when the asset was tracked.
      - `attributes` object — A string dictionary object containing attributes of the asset. These attributes were associated with the asset at the time of creating or updating it. attributes can be added to an asset using the *Update Asset Attributes* method.
      - `latest_location` object — An object with details of the last tracked location of the asset.
        - `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.
        - `timestamp` integer — A UNIX epoch timestamp in milliseconds, representing the time at which the location was tracked.
        - `accuracy` number — If available, this property returns the accuracy of the GPS information received at the last tracked location. It is represented as an estimated horizontal accuracy radius, in meters, at the 68th percentile confidence level.
        - `speed` number — If available in the GPS information, this property returns the speed of the asset, in meters per second, at the last tracked location.
        - `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 last 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).
        - `altitude` number — If available in the GPS information, this property returns the altitude of the asset at the last tracked location. It is represented as height, in meters, above the WGS84 reference ellipsoid.
      - `tags` string[] — **This parameter will be deprecated soon! Please move existing tags to attributes parameter.** Tags of the asset. These were associated with the asset when it was created or updated. tags can be used for filtering assets in operations like *Get Asset List* and asset **Search** methods. They can also be used for monitoring of assets using **Monitor** methods after linking tags and asset.
  - `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/versions/b647f1808dda/schema)