Get Tunnel Certificate

Changed on

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.

Fetches a tunnel certificate by ID.

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

Request

  • Base URL
    https://api.anthropic.com
  • Auth
    none declared

Path parameters

tunnel_idstring required

ID of the tunnel (tnl_...).

certificate_idstring required

ID of the certificate (tcrt_...).

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

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)

type'tunnel_certificate' required
idstring required

Unique identifier for the certificate, prefixed with tcrt_.

tunnel_idstring required

ID of the tunnel the certificate is registered against.

fingerprintstring required

Lowercase hex SHA-256 fingerprint of the certificate's DER encoding.

expires_atstring date-time nullable required

A timestamp in RFC 3339 format

created_atstring date-time required

RFC 3339 datetime string indicating when the certificate was registered.

archived_atstring date-time nullable required

A timestamp in RFC 3339 format

Changes

    • info

      added the enum value ce-claude-code-managed-settings-2026-10-06 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta

    • info

      added the enum value user-profiles-billing-2026-10-01 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta