List External Ports

Retrieve a list of external port records discovered by Huntress External Recon scans.

External Documentation

To learn more, visit the Huntress documentation.

​

Basic Parameters

Parameter	Description
Limit	The maximum number of results to return per page. Defaults to 10, with a minimum of 1 and a maximum of 500.
Organization ID	The ID of the organization to filter the results by.
Page Token	The token used to retrieve the next page of results.
Port	The port number to filter the external ports by.
Protocol	Select the protocol to filter the external ports by.
Return All Pages	Automatically fetch all resources, page by page.
Sort Direction	Select the sort direction for the results.
Sort Field	Select the field to sort the results by.

​

Advanced Parameters

Parameter	Description
Risky Service	Select to filter by whether the service is classified as risky.
Service	The service name to filter the external ports by (e.g., ssh, http, rdp).

​

Example Output

{
	"external_ports": [
		{
			"id": 42,
			"ip_address": "203.0.113.5",
			"port": 22,
			"protocol": "TCP",
			"service": "ssh",
			"risky_service": true,
			"last_scan_at": "2026-03-15T12:00:00Z",
			"last_external_scan_at": "2026-03-14T08:00:00Z",
			"organization_ids": [
				1,
				5
			]
		}
	],
	"pagination": {
		"next_page_url": "string",
		"next_page_token": "string"
	}
}