Sign in

List Tunnel Certificates

The Tunnels API is in research preview. It requires the anthropic-beta: mcp-tunnels-2026-06-22 header and may change without a deprecation period. It supersedes the Admin API endpoints at /v1/organizations/tunnels, which remain available during a migration window.

Lists the certificates registered on a tunnel. Archived certificates are excluded unless include_archived is set.

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

Path parameters

tunnel_idstring required

Path parameter tunnel_id

Query parameters

limitinteger

Maximum number of certificates to return per page. Defaults to 20, maximum 1000.

pagestring

Opaque pagination cursor from a previous list_tunnel_certificates response.

include_archivedboolean

Whether to include archived certificates in the results. Defaults to false.

Headers

x-api-keystring
anthropic-versionstring
anthropic-betastring
anthropic-workspace-idstring

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Response

Successful response (OK)

next_pagestring nullable required

Pagination cursor for the next page, or null if no more results.

Changes