Huntress icon

Huntress

Interact with Huntress API

Actions86

ExternalRecon → List External Ports

AI-generated

Summary

Lists external ports detected by Huntress, with optional filters for organization, protocol, port, risky-service status, and service name. Enable Return All to request paginated results; otherwise, the operation requests a single page.

Inputs

  • Return All — When enabled, fetches paginated results. When disabled, sends no pagination parameters and returns one page.
  • Additional Fields — Optional request parameters: limit, page token, sort field and direction, organization ID, protocol (TCP or UDP), port, risky-service flag, and detected service name.
  • Options — Optional custom JSON request body, custom HTTP headers, query filters, request batching, debug output, pagination settings, and timeout. Custom body values take priority when merged with the other fields.

Output shape

A list of external port records returned by the Huntress API.

With Return All disabled, results are limited to one page. With it enabled, results are paginated; the limit and page token fields are available in Additional Fields.

Examples

Example 1: List risky TCP ports for an organization

Set Organization Id, Protocol to TCP, and Risky Service to true. Enable Return All to fetch multiple pages if needed.

Links

Discussion