Skip to main content
Retrieve a list of all hosts in the system.
External DocumentationTo learn more, visit the Censys ASM documentation.

​
Parameters

ParameterDescription
Discovery TrailSelect to include only assets that have been discovered through a discovery trail.
Page NumberThe number of the page to retrieve.
Page SizeThe number of results to return per page.
Return All PagesAutomatically fetch all resources, page by page.
Skip Comment CountsSelect to exclude comment counts from the response.
SourceA comma-separated list of sources to filter by.
TagA comma-separated list of tags to filter by.
Tag OperatorThe operator to use for the tag filter.

​
Example Output

{
	"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
Workflow LibraryPreview this Workflow on desktop