> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List External Ports

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

<Note>
  External Documentation

  To learn more, visit the [Huntress documentation](https://api.huntress.io/docs#rest-api/tag/external-recon/GET/v1/external_ports).
</Note>

## Basic Parameters

<div className="integrations-table">
  | 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.                                                                          |
</div>

## Advanced Parameters

<div className="integrations-table">
  | 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`). |
</div>

## Example Output

```json theme={"dark"}
{
	"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"
	}
}
```

## Workflow Library Example

[List External Ports with Huntress and Send Results Via Email](https://library.blinkops.com/workflows/list-external-ports-with-huntress-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-external-ports-with-huntress-and-send-results-via-email/canvas" />
</div>
