curl -X GET 'https://api.anthropic.com/v1/tunnels?beta=true&limit=10&page=example-page&include_archived=true' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01'

# GET /v1/tunnels?beta=true (Claude API)
Base URL: https://api.anthropic.com
Auth: x-api-key; Anthropic API key; required.
Status: Beta.
Last verified: 2026-10-20

> List Tunnels

## Critical Gotchas
* Authentication uses the `x-api-key` header and requests also require an `anthropic-version` header.
* The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

## cURL
curl -X GET 'https://api.anthropic.com/v1/tunnels?beta=true&limit=10&page=example-page&include_archived=true' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| limit | query | integer | No | Maximum number of tunnels to return per page. Defaults to 20, maximum 1000. |
| page | query | string | No | Opaque pagination cursor from a previous `list_tunnels` response. |
| include_archived | query | boolean | No | Whether to include archived tunnels in the results. Defaults to false. |

## Response example
{"data":[{}],"next_page":"string"}

---
Need an API key? Get one at https://console.anthropic.com/settings/keys

GET

GET /v1/tunnels?beta=true — Claude API

Beta

Anthropic API key (required); https://api.anthropic.com

Claude API

List Tunnels

Base URL: https://api.anthropic.com
Auth: x-api-key: <ANTHROPIC_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 224 tokens · Vary: Accept

Critical gotchas

Authentication uses the x-api-key header and requests also require an anthropic-version header.

The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

cURL

curl -X GET 'https://api.anthropic.com/v1/tunnels?beta=true&limit=10&page=example-page&include_archived=true' \  -H "x-api-key: $ANTHROPIC_API_KEY" \  -H 'anthropic-version: 2023-06-01'

Parameters

Name	In	Type	Required	Description
limit	query	integer	No	Maximum number of tunnels to return per page. Defaults to 20, maximum 1000.
page	query	string	No	Opaque pagination cursor from a previous `list_tunnels` response.
include_archived	query	boolean	No	Whether to include archived tunnels in the results. Defaults to false.

Response 200 OK

{
  "data": [
    {
      "type": "string",
      "id": "string",
      "domain": "string",
      "display_name": "string",
      "created_at": "2026-09-03T00:00:00Z",
      "archived_at": "2026-09-03T00:00:00Z"
    }
  ],
  "next_page": "string"
}

Get a free Claude API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.