---
title: "List External Ports"
method: GET
path: "/v1/external_ports"
tags: ["External Recon"]
---

# List External Ports

`GET /v1/external_ports`

Shows external port records from External Recon scans associated with your account.

## Query parameters

- `limit` integer
- `page_token` string
- `sort_field` 'id' | 'port' | 'protocol' | 'created_at' | 'updated_at'
- `sort_direction` 'asc' | 'desc'
- `organization_id` integer
- `protocol` 'TCP' | 'UDP'
- `port` integer
- `risky_service` boolean
- `service` string

## Response `200`

List External Ports

- object
  - `external_ports` ExternalPort[], required
    - `id` integer — A unique identifier for an external port record.
    - `ip_address` string — The public IPv4 address associated with this external port.
    - `port` integer — The port number.
    - `protocol` string — The transport protocol (usually TCP or UDP).
    - `service` string — The service or application detected on the port.
    - `risky_service` boolean — Whether the detected service is considered risky.
    - `last_scan_at` string, date-time — Timestamp of the last Huntress scan, formatted as per ISO-8601.
    - `last_external_scan_at` string, date-time — Timestamp of the last external scan, formatted as per ISO-8601.
    - `organization_ids` unknown[] — IDs of organizations associated with this external port that are accessible to the current user.
      - unknown
  - `pagination` Pagination, required — Pagination model
    - `next_page_url` string
    - `next_page_token` string

## Other responses

- `403` — There was an issue with your API credential or permissions.

---

[API](https://skmtc.net/huntress/apis/huntress-api-reference.md) · [All operations](https://skmtc.net/huntress/apis/huntress-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huntress/huntress-api-reference/revisions/94acb422c07d/schema)