---
title: "Get the user's active tunnel"
method: GET
path: "/v1/tunnel"
tags: ["Tunnel"]
---

# Get the user's active tunnel

`GET /v1/tunnel`

Returns the first active tunnel for the authenticated account (regardless of ID). Convenience endpoint when you only run one tunnel at a time.

## Response `200`

Get the user's active tunnel

- TestingbotEntitiesTunnel — Testingbot_Entities_Tunnel model
  - `id` integer, required — Unique numeric tunnel ID.
  - `state` string, required — Tunnel lifecycle state (READY, STOPPED, …).
  - `private_ip` string, required — Internal IP of the tunnel VM, used to chain the tunnel with BrowserMob.
  - `ip` string, required — Public IP of the tunnel VM. Only present once `state` is READY.
  - `version` string, required — Latest tunnel client version TestingBot supports.

## Other responses

- `401` — Authentication required

---

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