Sign in

v1

latestOpenAPI 3.1.02026-07-2489171167.4 KB
Assets

Get an Asset by ID

get/assets/{id}

Response

Successful operation.

namestring

The name of the asset.

typestring nullable

The asset type (Laptop / Smartphone / etc.).

sourcestring nullable

The origin of the asset, describing how it was added to the system.

manufacturerstring nullable

The manufacturer of the asset.

modelstring nullable

The model of the asset.

serialstring nullable

The asset's serial number according to the manufacturer.

descriptionstring nullable

The description of the asset.

isDisabledboolean

Indicates whether the asset is disabled. When true, automatic inventory updates, monitoring, and all other SysAid Agent capabilities are turned off for the asset.

ownerIdnumber nullable

The unique ID of the user who owns the asset.

ownership'personal' | 'company' nullable

Defines who is the official owner of the asset - the employee or the company.

companyIdnumber nullable

The unique ID of the company the asset belongs to.

locationIdnumber nullable

The unique ID of the asset’s location.

departmentIdnumber nullable

The unique ID of the department the asset belongs to.

warrantyExpirationstring date nullable

The date when the asset’s warranty expires.

patchManagementEnabledboolean

Indicates if patch management is enabled for the asset. To learn more, see SysAid Patch Management Guide.

customFieldsFlattenedCustomColumnsFields
additionalDatastring nullable

Additional data available for the asset.

idstring

The asset’s unique ID within SysAid. Cannot be changed.

updateTimestring date-time nullable

The timestamp of when the asset was last updated in SysAid in ISO‑8601 format.

versionnumber nullable

The asset object version. Cannot be changed.

Example response

{
  "name": "KATANA-GF66",
  "type": "laptop",
  "source": "agent",
  "manufacturer": "MSI",
  "model": "GF66 11UG-871",
  "serial": "SN1A2B3C4",
  "description": "Very cool asset!",
  "ownerId": 10293,
  "ownership": "personal",
  "companyId": 7,
  "locationId": 14,
  "departmentId": 3,
  "warrantyExpiration": "2026-05-13",
  "patchManagementEnabled": true,
  "os": {
    "name": "Windows",
    "version": "11 Pro 24H2"
  },
  "network": {
    "macAddresses": [
      "18:3D:A2:55:67:10",
      "18:3D:A2:55:67:11"
    ],
    "ipAddresses": [
      "10.178.3.44",
      "10.178.3.45"
    ]
  },
  "customFields": {
    "cust_col1": "val1",
    "cust_col21": "val2"
  },
  "additionalData": "Uptime (in seconds): 23945770\nUser domain: EXAMPLE",
  "id": "MSI-123",
  "updateTime": "2025-07-27T18:09:55Z",
  "version": 1
}