> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Assets

Returns a list of assets.

<Note>
  External Documentation

  To learn more, visit the [Sekoia.io documentation](https://docs.sekoia.io/developer/api/#tag/Assets/search_assets_v2_asset_management_assets_get).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                              |
  | ---------------- | -------------------------------------------------------- |
  | Asset Categories | A comma separated list of asset categories to filter by. |
  | Asset Name       | Filter by the asset's name.                              |
  | Asset Types      | A comma separated list of asset types to filter by.      |
  | Asset UUIDs      | A comma separated list of asset UUIDs to filter by.      |
  | Direction        | The direction of the sort.                               |
  | Return All Pages | Automatically fetch all resources, page by page.         |
  | Sort             | Sort returned assets by a provided field.                |
  | Sources          | A comma separated list of asset sources to filter by.    |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                      | Description                                                                       |
  | ------------------------------ | --------------------------------------------------------------------------------- |
  | Community UUIDs                | A comma separated list of asset community UUIDs to filter by.                     |
  | Include Revoked                | Select to include revoked assets in the search results.                           |
  | Incorporate Atoms              | Select to enrich returned assets with their detection properties.                 |
  | Limit                          | The number of items to retrieve. The allowed range is 1-100. The default is `20`. |
  | Offset                         | The number of items to skip when paginating. Must be bigger or equal to `0`.      |
  | Reviewed                       | If set to `True`, filters reviewed assets only.                                   |
  | Rule UUIDs                     | A comma separated list of asset rule UUIDs to filter by.                          |
  | Rule Version                   | A comma separated list of asset discovery rules versions to filter by.            |
  | Search In Detection Properties | Select to search by attached detection property.                                  |
  | Search In Tags                 | Select to search by asset tags.                                                   |
  | With Telemetry                 | Select to Enrich returned assets with their telemetry statistics.                 |
</div>

## Example Output

```json theme={"dark"}
{
	"total": 54,
	"items": [
		{
			"uuid": "<string>",
			"community_uuid": "<string>",
			"name": "<string>",
			"type": "<string>",
			"criticality": 2,
			"created_at": "<string>",
			"created_by_type": "<string>",
			"updated_at": "<string>",
			"nb_atoms": 2,
			"props": {
				"sekoia.io_agent_id": "<string>",
				"os": "<string>",
				"os_type": "<string>"
			},
			"tags": [],
			"revoked": false,
			"reviewed": false,
			"source": "<string>"
		},
		{
			"uuid": "<string>",
			"community_uuid": "<string>",
			"name": "<string>",
			"type": "<string>",
			"criticality": 1,
			"created_at": "<string>",
			"created_by_type": "<string>",
			"updated_at": "<string>",
			"nb_atoms": 0,
			"props": {
				"sekoia.io_agent_id": "<string>",
				"os": "<string>",
				"os_type": "<string>"
			},
			"tags": [],
			"revoked": false,
			"reviewed": false,
			"source": "<string>"
		}
	]
}
```

## Workflow Library Example

[List Assets with Sekoiaio and Send Results Via Email](https://library.blinkops.com/workflows/list-assets-with-sekoiaio-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-assets-with-sekoiaio-and-send-results-via-email/canvas" />
</div>
