---
title: "List External Ports"
method: GET
path: "/v1/accounts/{account_id}/external_ports"
tags: ["Reseller"]
---

# List External Ports

`GET /v1/accounts/{account_id}/external_ports`

## Request

- Base URL: `https://api.huntress.io`
- URL: `https://api.huntress.io/v1/accounts/{account_id}/external_ports`
- Auth: `basic` (a scheme the document does not define)

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

## Path parameters

- `account_id` integer, required

## 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.dev/huntress/apis/huntress-api-reference.md) - [All operations](https://skmtc.dev/huntress/apis/huntress-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/huntress/apis/huntress-api-reference/revisions/f593a257b4cc?raw)