---
title: "Get list of assets"
method: GET
path: "/assets"
tags: ["Assets"]
---

# Get list of assets

`GET /assets`

Retrieves a list of assets.

## Query parameters

- `limit` integer
- `offset` integer
- `sortBy` 'id' | 'name' | 'type' | 'manufacturer' | 'model' | 'serial' | 'ownerId' | 'source' | 'ownership' | 'companyId' | 'locationId' | 'departmentId' | 'updateTime' | 'warrantyExpiration'
- `sortDir` 'asc' | 'desc'
- `query` string
- `id` string[]
- `source` string[]
- `ownership` string[]
- `isDisabled` boolean
- `ownerId` integer[]
- `name` string
- `type` string
- `description` string
- `ipAddresses` string
- `macAddresses` string
- `manufacturer` string
- `model` string
- `serial` string
- `companyId` integer[]
- `departmentId` integer[]
- `locationId` integer[]

## Response `200`

Returns a list of assets.

- GetAssetsResponse
  - `limit` integer — The number of items that are returned per page
  - `offset` integer — The offset used for pagination.
  - `total` integer — The total number of elements across all pages.
  - `data` Asset[]
    - `name` string — The name of the asset.
    - `type` string, nullable — The asset type (Laptop / Smartphone / etc.).
    - `source` string, nullable — The origin of the asset, describing how it was added to the system.
    - `manufacturer` string, nullable — The manufacturer of the asset.
    - `model` string, nullable — The model of the asset.
    - `serial` string, nullable — The asset's serial number according to the manufacturer.
    - `description` string, nullable — The description of the asset.
    - `isDisabled` boolean — Indicates whether the asset is disabled. When true, automatic inventory updates, monitoring, and all other SysAid Agent capabilities are turned off for the asset.
    - `ownerId` number, 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.
    - `companyId` number, nullable — The unique ID of the company the asset belongs to.
    - `locationId` number, nullable — The unique ID of the asset’s location.
    - `departmentId` number, nullable — The unique ID of the department the asset belongs to.
    - `warrantyExpiration` string, date, nullable — The date when the asset’s warranty expires.
    - `patchManagementEnabled` boolean — Indicates if patch management is enabled for the asset. To learn more, see SysAid Patch Management Guide.
    - `os` OperatingSystem, nullable — Operating System properties.
      - `name` string, nullable — The name of the Operating System.
      - `version` string, nullable — The version of the Operating System.
    - `network` Network, nullable — Network properties.
      - `macAddresses` string[] — The MAC addresses that belong to the asset.
      - `ipAddresses` string[] — The IP addresses of the asset.
    - `customFields` FlattenedCustomColumnsFields
    - `additionalData` string, nullable — Additional data available for the asset.
    - `id` string — The asset’s unique ID within SysAid. Cannot be changed.
    - `updateTime` string, date-time, nullable — The timestamp of when the asset was last updated in SysAid in ISO‑8601 format.
    - `version` number, nullable — The asset object version. Cannot be changed.

## Other responses

- `401` — Authentication information is missing or invalid

---

[API](https://skmtc.net/sysaid/apis/sysaid-public-api.md) · [All operations](https://skmtc.net/sysaid/apis/sysaid-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sysaid/sysaid-public-api/versions/38a43a1b2981/schema)