---
title: "Asset Search"
method: POST
path: "/api/3/assets/search"
tags: ["Asset"]
---

# Asset Search

`POST /api/3/assets/search`

Returns all assets for which you have access that match the given search criteria.

## Query parameters

- `page` integer
- `size` integer
- `sort` string[]

## Request body

- SearchCriteria — The search criteria specification.
  - `filters` SwaggerSearchCriteriaFilter[] — Filters used to match assets. See <a href="#section/Responses/SearchCriteria">Search Criteria</a> for more information on the structure and format.
    - `field` string — The filter field for the search criteria.
    - `lower` object — The lower value to match in a range criteria.
    - `operator` string — The operator on how to match the search criteria.
    - `upper` object — The upper value to match in a range criteria.
    - `value` object — The single value to match using the operator.
    - `values` object[] — An array of values to match using the operator.
  - `match` 'any' | 'all' — Operator to determine how to match filters. `all` requires that all filters match for an asset to be included. `any` requires only one filter to match for an asset to be included.

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error
- `503` — Service Unavailable

---

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