---
title: "List Sandbox Services"
method: GET
path: "/api/v1/runs/{id}/sandbox/services"
tags: ["Human-in-the-Loop"]
---

# List Sandbox Services

`GET /api/v1/runs/{id}/sandbox/services`

Lists listening TCP services discovered inside the run sandbox.

## Path parameters

- `id` string, required

## Response `200`

Listening TCP services

- SandboxServiceListResponse — Non-paginated list of listening TCP services in a run sandbox.
  - `data` SandboxService[], required
    - `port` integer, required — Listening TCP port.
    - `addresses` string[], required — Local bind addresses discovered from `ss` or `/proc/net/tcp*`.
    - `processes` string[], required — Visible process summaries when available. Empty when the sandbox only supports `/proc/net/tcp*` discovery.
    - `preview_supported` boolean, required — Whether the provider supports an external preview URL for this port.
  - `meta` SandboxServiceListMeta, required — Metadata about sandbox service discovery.
    - `source` 'ss' | 'procfs', required — Tool or kernel interface used to discover sandbox services.

## Other responses

- `404` — Run not found
- `409` — Run has no active sandbox or service discovery failed

---

[API](https://skmtc.net/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.net/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/versions/bee030053823/schema)