Retrieves details of a specified endpoint.

Required API key role permissions:

  • Endpoint Inventory - view

External Documentation

To learn more, visit the Trend Vision One documentation.

​
Parameters

ParameterDescription
Agent GUIDThe ID of an installed agent on an endpoint. For example: 9c94bd33-c589-48c4-9431-dace397b0067.Can be obtained by using the List Endpoints action.

​
Example Output

{
	"endpointName": "example-hostname",
	"agentGuid": "94222d63-90da-a1eb-a051-a85d6b61f5fe",
	"displayName": "example-display-name",
	"description": "example-description",
	"type": "desktop",
	"os": {
		"name": "Windows 11",
		"platform": "unknown",
		"architecture": "unknown",
		"version": "10.0.22621",
		"kernelVersion": "10.0.22621"
	},
	"lastUsedIp": "192.168.1.100",
	"serviceGatewayOrProxy": "www.example.com (192.0.2.1:8080, 192.0.2.2:8080)",
	"cpuArchitecture": "The CPU architecture of the endpoint.",
	"lastLoggedOnUser": "Example user",
	"isolationStatus": "unknown",
	"recommendedActions": [
		"precheck_windows_tool_103"
	],
	"interfaces": [
		{
			"ipAddresses": [
				"192.168.0.1",
				"10.1.1.253"
			],
			"macAddress": "ff:ff:00:00:00:ff"
		}
	],
	"serialNumber": 123456,
	"eppAgent": {
		"endpointGroup": "Computers",
		"protectionManager": "A1-US",
		"policyName": "Example Policy Name",
		"status": "unknown",
		"lastConnectedDateTime": "2023-02-06T10:00:00Z",
		"tags": [
			"example1"
		],
		"version": "1.2.3.4",
		"lastScannedDateTime": "2023-02-06T10:00:00Z",
		"componentVersion": "outdatedVersion",
		"componentUpdatePolicy": "N-2",
		"componentUpdateStatus": "pause",
		"installedComponentIds": [
			"1208221992"
		],
		"domainHierarchy": "/example/example-sub-domain",
		"virtualMachineDetails": [
			{
				"key": "example key",
				"value": "example value"
			}
		],
		"dsaComponentUpdateStatus": "up to date",
		"dsaAgentUpdateStatus": "up to date",
		"dsaComponentUpdatedDateTime": "2023-02-08T10:00:00Z",
		"gcpNetworkTags": [
			"example1",
			"example2"
		],
		"dockerEngineVersion": "up to date",
		"patterns": [
			{
				"id": "512",
				"name": "Common Firewall Pattern",
				"version": "2.219.00",
				"updatedDateTime": "2023-02-06T10:00:00Z"
			}
		],
		"engines": [
			{
				"id": "1207960102",
				"name": "Advanced Threat Scan Engine",
				"version": "23.600.10",
				"updatedDateTime": "2023-02-06T10:00:00Z"
			}
		],
		"features": [
			{
				"name": "AntiMalwareScans",
				"status": "enabled",
				"outdatedPatternIds": [
					"1208221762"
				],
				"notCompliantSubFeatures": [
					{
						"name": "BehaviorMonitoring",
						"status": "enabled"
					}
				]
			}
		]
	},
	"edrSensor": {
		"endpointGroup": "Example XES Group Name",
		"connectivity": "unknown",
		"lastConnectedDateTime": "2023-02-06T10:00:00Z",
		"version": "1.2.3.4",
		"status": "unknown",
		"advancedRiskTelemetryStatus": "unknown"
	}
}

​
Workflow Library Example

Get Endpoint with Trend Vision One and Send Results Via Email

Preview this Workflow on desktop

Was this page helpful?

Get AlertGet Task Status