---
title: "List ports"
method: GET
path: "/api/projects/{projectId}/sessions/{sessionId}/ports"
tags: ["Ports"]
---

# List ports

`GET /api/projects/{projectId}/sessions/{sessionId}/ports`

List TCP listening ports in a session sandbox. Returns the requested resource or collection for the authenticated caller.

## Path parameters

- `projectId` string, required
- `sessionId` string, required

## Response `200`

Ports

- ListPortsResponse — Ports Response payload returned by the API.
  - `ports` PortEntry[], required
    - `localAddress` string, required
    - `port` integer, required
    - `process` string
    - `pid` integer, required
    - `fd` integer
    - `protocol` 'http' | 'https' | 'unknown', required — Detected application protocol for the listening port.

## Changes

- **2026-06-03** `b18486c48a70` — 1 info
  - endpoint added
- **2026-05-29** `2d34481e85d7` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ibuildthecloud/apis/discobot-server-api/changes/api/projects/:projectId/sessions/:sessionId/ports/get.md)

---

[API](https://skmtc.dev/ibuildthecloud/apis/discobot-server-api.md) · [All operations](https://skmtc.dev/ibuildthecloud/apis/discobot-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibuildthecloud/discobot-server-api/revisions/4de3fcd6be56/schema)