Skip to main content
Retrieve a specific host by its IP address.
External DocumentationTo learn more, visit the Censys ASM documentation.

Parameters

ParameterDescription
IP AddressThe IP address of the host to retrieve.
Skip Comment CountsSelect to exclude comment counts from the response.

Example Output

{
	"associatedAt": "2026-02-20T14:32:10Z",
	"source": "CENSYS_SCAN",
	"risks": [
		{
			"type": "HOST_RISK",
			"port": 443,
			"transportProtocol": "TCP",
			"name": "TLS Certificate Expiring Soon",
			"categories": [
				"TLS",
				"Certificate"
			],
			"title": "TLS Certificate Expiration Warning",
			"severity": "MEDIUM"
		}
	],
	"data": {
		"ipAddress": "192.0.2.10",
		"names": {
			"forwardDns": [
				{
					"name": "example.com",
					"resolvedAt": "2026-02-20T13:00:00Z"
				}
			],
			"reverseDns": [
				{
					"name": "host.example.com",
					"resolvedAt": "2026-02-20T13:05:00Z"
				}
			]
		},
		"protocols": [
			{
				"transportProtocol": "TCP",
				"port": 443,
				"protocol": "HTTPS",
				"software": [
					{
						"name": "nginx",
						"version": "1.25.3",
						"uri": "cpe:2.3:a:nginx:nginx:1.25.3",
						"part": "a",
						"vendor": "nginx",
						"product": "nginx",
						"vendorName": "NGINX Inc.",
						"productName": "NGINX",
						"isEol": false
					}
				],
				"base64EncodedBanner": "SFRUUC8xLjEgMjAwIE9L",
				"certificates": [
					{
						"sha256": "a3f5c2d4e6b7890f1234567890abcdef1234567890abcdef1234567890abcdef",
						"refUrl": "https://example.com/cert/a3f5c2"
					}
				]
			}
		],
		"asn": 64500,
		"cloud": "AWS",
		"location": {
			"countryCode": "US",
			"province": "California",
			"latitude": 37.7749,
			"longitude": -122.4194
		},
		"cdn": [
			"CloudFront"
		],
		"classifications": [
			"production",
			"external-facing"
		]
	},
	"comments": {
		"totalComments": 2,
		"refUrl": "https://example.com/assets/asset-123/comments"
	},
	"type": "HOST",
	"assetId": "asset-123",
	"isSeed": true,
	"tags": [
		{
			"name": "critical",
			"color": "#FF0000"
		}
	],
	"discoveryTrail": [
		{
			"type": "IP_ADDRESS",
			"assetId": "asset-123",
			"isSeed": true,
			"refUrl": "https://example.com/discovery/ip/192.0.2.10"
		},
		{
			"type": "ASN",
			"assetId": "asset-456",
			"isSeed": false,
			"refUrl": null
		}
	]
}

Workflow Library Example

Get Host with Censys Asm and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop