---
title: "List Ports"
method: GET
path: "/api/ports"
tags: ["Ports"]
---

# List Ports

`GET /api/ports`

## Request

- Base URL: `https://api.fiber.ac` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fiber.ac/api/ports`
- Auth: none declared

List all monitored optical ports with real-time telemetry, risk scores, and severity classification. Supports filtering by vendor, severity, and speed. Coherent ports (400ZR) include additional metrics: SNR, OSNR, CD, PMD, pre-FEC BER. When the ClickHouse schema carries the OpenConfig transceiver v1.0.0 per-channel extension, each port also includes rx_los_count, tx_los_count, rx_lol_count, tx_lol_count, tx_fault_count (cumulative, summed over lanes) and media_snr / host_snr (worst lane, dB; null = not reported) plus `link_integrity_reported` — false when the device does not expose these leaves (all of those fields are then null rather than 0); `link_integrity_columns` lists which of those the deployment provides.

## Query parameters

- `vendor` string, nullable: Filter by vendor
- `severity` string, nullable: Filter by severity: normal, warning, critical
- `speed` string, nullable: Filter by speed: 400G, 800G, 400ZR
- `search` string, nullable: Substring match on switch name, port name, or serial
- `sort_by` string: Sort key
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of ports with telemetry readings, risk scores, and severity labels

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fiber-ac/apis/fiber-api.md) · [All operations](https://skmtc.dev/fiber-ac/apis/fiber-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fiber-ac/apis/fiber-api/revisions/58267250d793?raw)