Assets

Retrieve an Asset

Changed on

OAuth Scope

This endpoint requires the following OAuth scope read_assets.

get/asset/{uuid}.json

Request

  • Base URL
    https://api.servicem8.com/api_1.0
  • URL
    https://api.servicem8.com/api_1.0/asset/{uuid}.json
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.servicem8.com/oauth/authorize
      Token URL: https://api.servicem8.com/oauth/access_token scopes: read_assets

Path parameters

uuidstring uuid required

UUID of the Asset

Response

Asset record retrieved successfully

uuidstring uuid

Unique identifier for this record

active0 | 1

Record active/deleted flag. Valid values are [0,1]

edit_datestring

Timestamp at which record was last modified

company_uuidstring uuid

UUID of the Client to which this Asset is attached

asset_codestring

The unique code printed on this Asset's attached label (read only)

asset_type_uuidstring uuid

UUID of an Asset Type which defines the fields that can be stored for this Asset (read only)

namestring

User-facing description of this asset

latnumber float

Latitude component of the Asset's location in degrees

lngnumber float

Longitude component of the Asset's location in degrees

geo_timestampstring

Timestamp at which the Asset's location was last updated

altitudenumber

Altitude component of the Asset's location in metres

Example response

{
  "uuid": "123e4567-dd5e-4b3d-a4bd-23f94042120b",
  "edit_date": "2026-03-01 12:00:00",
  "company_uuid": "123e4567-6ac6-439b-a3f3-23f94a0de2ab",
  "asset_type_uuid": "123e4567-c5b4-4a6e-ad3e-23f9440b9bfb",
  "geo_timestamp": "2026-03-01 12:00:00"
}

Changes

  • ca9b053c4373Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status