---
title: "List asset statuses"
method: GET
path: "/assetstatuses"
tags: ["Asset Statuses"]
---

# List asset statuses

`GET /assetstatuses`

Endpoint used to list assetStatuses resources

## Query parameters

- `cursor` string — Last pagination reference
- `limit` integer — max number of Asset Statuses returned
- `assetId` integer[] — To filter by multiple assetId IDs: `assetIds=630`
- `sort` 'createdAt' | 'updatedAt' | 'startedAt' | 'endedAt' | '-createdAt' | '-updatedAt' | '-startedAt' | '-endedAt' — Attribute on which to sort the list. (for descending order, prefix attribute with '-'). The default sorting key is : created_at and direction descending

## Headers

- `x-organization-id` integer

## Response `200`

Successfully fetched Asset Statuses list

- object
  - `assetStatuses` object[], required
    - `id` number — Global ID of the asset status.
    - `customStatusId` number, nullable — Id of the custom status assigned to asset.
    - `assetId` number — Global Parent asset ID of the asset status.
    - `status` 'IGNORE' | 'OFFLINE' | 'ONLINE' — Asset status value.
    - `downtimeType` 'PLANNED' | 'UNPLANNED', nullable — Downtime type of the asset status.
    - `startedAt` string, date-time — Date & time at which the asset status was started at.
    - `endedAt` string, date-time, nullable — Date & time at which the asset status ended at. Null means this status is still active, and is the current one.
    - `organizationId` number — The Organization ID of the asset status.
    - `creatorId` number — The Creator ID of the asset status.
    - `updaterId` number, nullable — The Updater ID of the asset status.
    - `createdAt` string, date-time — Date & time at which the asset status was created. This is the default sort by field, by descending (newest firsts)
    - `updatedAt` string, date-time — Date & time at which the asset status was last updated.
    - `deletedAt` string, date-time, nullable — Date & time at which the asset status was deleted.
    - `description` string, nullable — Description of the asset status.
  - `nextCursor` string, nullable, required — The cursor to retrieve the next page of Asset Statuses.
  - `nextPageUrl` string, nullable, required — Path with query parameters that can be used to retrieve the next page of Asset Statuses.

## Other responses

- `400` — Error with query
- `401` — Invalid token

---

[API](https://skmtc.net/getmaintainx/apis/maintainx-api.md) · [All operations](https://skmtc.net/getmaintainx/apis/maintainx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getmaintainx/maintainx-api/revisions/ef9153fcac7c/schema)