> ## 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 Hosts

Retrieve a list of all hosts in the system.

<Note>
  External Documentation

  To learn more, visit the [Censys ASM documentation](https://app.censys.io/api-docs).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter           | Description                                                                        |
  | ------------------- | ---------------------------------------------------------------------------------- |
  | Discovery Trail     | Select to include only assets that have been discovered through a discovery trail. |
  | Page Number         | The number of the page to retrieve.                                                |
  | Page Size           | The number of results to return per page.                                          |
  | Return All Pages    | Automatically fetch all resources, page by page.                                   |
  | Skip Comment Counts | Select to exclude comment counts from the response.                                |
  | Source              | A comma-separated list of sources to filter by.                                    |
  | Tag                 | A comma-separated list of tags to filter by.                                       |
  | Tag Operator        | The operator to use for the tag filter.                                            |
</div>

## Example Output

```json theme={"dark"}
{
	"pageNumber": 0,
	"pageSize": 0,
	"totalPages": 0,
	"totalItems": 0,
	"assets": [
		{
			"assetId": "string",
			"type": "HOST",
			"associatedAt": "string",
			"source": "string",
			"isSeed": true,
			"tags": [
				{
					"name": "string",
					"color": "string"
				}
			],
			"risks": [
				{
					"type": "HOST_RISK",
					"port": 0,
					"transportProtocol": "string",
					"name": "string",
					"categories": [
						"string"
					],
					"title": "string",
					"severity": "string"
				}
			],
			"discoveryTrail": [
				{
					"type": "ASN",
					"assetId": "string",
					"isSeed": true,
					"refUrl": "string"
				}
			],
			"comments": {
				"totalComments": 0,
				"refUrl": "string"
			},
			"data": {
				"asn": 0,
				"cdn": [
					"string"
				],
				"classifications": [
					"string"
				],
				"cloud": "string",
				"ipAddress": "string",
				"location": {
					"latitude": 0,
					"longitude": 0,
					"countryCode": "string",
					"province": "string"
				},
				"names": {
					"forwardDns": [
						{
							"name": "string",
							"resolvedAt": "string"
						}
					],
					"reverseDns": [
						{
							"name": "string",
							"resolvedAt": "string"
						}
					]
				},
				"protocols": [
					{
						"port": 0,
						"protocol": "string",
						"transportProtocol": "string",
						"base64EncodedBanner": "string",
						"software": [
							{
								"uri": "string",
								"name": "string",
								"part": "",
								"isEol": true,
								"source": "string",
								"vendor": "string",
								"product": "string",
								"version": "string"
							}
						],
						"certificates": [
							{
								"sha256": "string",
								"refUrl": "string"
							}
						]
					}
				]
			}
		}
	]
}
```

## Workflow Library Example

[List Hosts with Censys Asm and Send Results Via Email](https://library.blinkops.com/workflows/list-hosts-with-censys-asm-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-hosts-with-censys-asm-and-send-results-via-email/canvas" />
</div>