Sign in

List Tunnel Certificates

Deprecated. This Admin API endpoint is superseded by /v1/tunnels on the Claude API and will be removed after a migration window. New integrations should use /v1/tunnels with the anthropic-beta: mcp-tunnels-2026-06-22 header and a WIF token carrying the workspace:manage_tunnels scope. Existing integrations continue to work with the mcp-tunnels-2026-05-19 header and org:manage_tunnels scope during the migration window.

List the certificates registered on a tunnel.

Archived certificates are excluded unless include_archived is set.

get/v1/organizations/tunnels/{tunnel_id}/certificates?beta=true

Path parameters

tunnel_idstring required

ID of the Tunnel.

ID of the Tunnel.

Query parameters

pagestring nullable

A tunnel has at most two active certificates, so this list is not paginated.

A tunnel has at most two active certificates, so this list is not paginated.

limitinteger

Maximum number of certificates to return.

Maximum number of certificates to return.

include_archivedboolean

Include archived certificates in the results. Archived certificates are excluded by default.

Include archived certificates in the results. Archived certificates are excluded by default.

Headers

anthropic-betastring required

This endpoint is in beta: requests must send mcp-tunnels-2026-05-19 in this header.

This endpoint is in beta: requests must send mcp-tunnels-2026-05-19 in this header.

x-api-keystring

Your unique Admin API key for authentication.

This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the Console.

Your unique Admin API key for authentication.

This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the Console.

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Response

Successful Response

next_pagestring nullable required

Opaque cursor for the next page, or null if there are no more results.

Example response

{
  "data": [
    {
      "archived_at": "2024-11-01T23:59:27.427722Z",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "expires_at": "2024-10-30T23:58:27.427722Z",
      "fingerprint": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "id": "tcrt_01JmWq4ZxnBvR7tKpY2sLdH9",
      "tunnel_id": "tnl_01Hx9Kp2RtQvMn3sWbYdLcF8"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Changes