---
title: "List TCP port forwards for a Cube"
method: GET
path: "/spaces/{spaceId}/cubes/{cubeId}/tcp-mappings"
tags: ["TCP mappings"]
---

# List TCP port forwards for a Cube

`GET /spaces/{spaceId}/cubes/{cubeId}/tcp-mappings`

## Request

- Base URL: `https://krova.cloud/api/v1`
- URL: `https://krova.cloud/api/v1/spaces/{spaceId}/cubes/{cubeId}/tcp-mappings`
- Auth: API key in header `X-API-KEY`

## Path parameters

- `spaceId` string, required
- `cubeId` string, required

## Response `200`

TCP mapping list

- object
  - `tcpMappings` TcpMapping[], required
    - `id` string, required
    - `cubeId` string, required
    - `cubePort` integer, required
    - `host` string, nullable: Where to connect for this mapping: `host:hostPort`. The Cube's own stable hostname, which survives migration to another server, falling back to the server's public IP when the Cube has no DNS record yet. Identical to `host` from GET .../ssh, and the same value for every mapping on a Cube. Null only when the Cube has no server assigned, in which case there is nowhere to connect. Do NOT use `serverDomain` from the Cube object — that is the current physical host and changes when the Cube moves.
    - `hostPort` integer, required
    - `label` string, nullable, required
    - `status` string, required
    - `isSsh` boolean, required
    - `udpEnabled` boolean, required: Whether this mapping also forwards UDP on the same host port. True means TCP and UDP; false means TCP only. Always false for the platform SSH mapping.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `whitelistedIps` object[], required
      - `id` string, required
      - `cidr` string, required

---

[API](https://skmtc.dev/krova/apis/krova-cloud-api.md) · [All operations](https://skmtc.dev/krova/apis/krova-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/krova/apis/krova-cloud-api/revisions/46bb68281ce1?raw)