---
title: "Search Assets"
method: GET
path: "/v1/asset/"
tags: ["Assets"]
---

# Search Assets

`GET /v1/asset/`

Search for assets that match the provided search terms.

Keywords are searched for in the _name_, _vin_, _model_ and _colour_ fields.

Additional explicit filters are also supported

## Query parameters

- `query` string, nullable
- `skip` integer, nullable
- `limit` integer, nullable
- `sort_direction` 'asc' | 'desc' — Direction to sort the `sort_column` - ascending or descending.
- `date_start` string, date-time, nullable
- `date_cut_off` string, date-time, nullable
- `sort_column` 'updated_at' | 'created_at' | 'id' — Which column to sort on
- `type_id` integer, nullable
- `project_id` integer, nullable
- `project_id_isnull` boolean, nullable
- `model` string, nullable
- `colour` string, nullable
- `is_maintenance_required` boolean, nullable
- `is_archived` boolean, nullable

## Response `200`

Successful Response

- ApiGenericListResponseAssetModel
  - `error` boolean — A boolean error indicator.
  - `message` string, nullable — Optional message.
  - `data` AssetModel[], nullable — The response data for any given request.
    - `companyId` integer, required — The company identifier of the asset
    - `id` integer, required — The asset identifier
    - `name` string, required — The asset name
    - `typeId` integer, required — The type identifier of the asset
    - `siteId` integer, nullable — The site identifier of the asset
    - `fuelTypeId` integer, nullable — The fuel type identifier of the asset
    - `vin` string, nullable — The vehicle identification number of the asset
    - `model` string, nullable — The model of the asset
    - `description` string, nullable
    - `colour` string, nullable — The colour of the asset
    - `image` string, nullable — An image of the asset
    - `hours` number, nullable — The hours of the asset
    - `year` integer, nullable — The year of the asset
    - `isMaintenanceRequired` boolean, required — Determines if maintenance is required on the asset
    - `isArchived` boolean, required — Determines if the asset is archived
    - `kmsMiles` number, nullable — The KMs or miles of the asset
    - `cost` number, nullable — The cost of the asset
    - `lastCheckin` string, date-time, nullable — A timestamp of the last check-in of the asset
    - `lastMaintenance` string, date-time, nullable — A timestamp of the last maintenance of the asset
    - `insuranceDate` string, date-time, nullable — The insurance date of the asset

## Other responses

- `400` — Business Logic Error
- `403` — Permission Error
- `404` — Records Not Found
- `409` — Integrity Error or Data Conflict
- `422` — Validation Error

---

[API](https://skmtc.dev/salussafety/apis/salus-developer-api.md) · [All operations](https://skmtc.dev/salussafety/apis/salus-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salussafety/salus-developer-api/revisions/ef065f44da25/schema)