Get a Cloudflare Tunnel

GET /accounts/{account_id}/cfd_tunnel/{tunnel_id}

Copy endpoint

https://api.cloudflare.com/client/v4

Fetches a single Cloudflare Tunnel.

Parameters

path Path Parameters

Name	Type
`account_id` required	type TunnelAccountId = string
`tunnel_id` required	type TunnelTunnelId = string

Responses

200 application/json

Get a Cloudflare Tunnel response

type TunnelTunnelResponseSingle = interface TunnelApiResponseCommon {
errors:

TunnelMessages

type TunnelMessages = { code: number;message: string; }[]

;
messages:

TunnelMessages

type TunnelMessages = { code: number;message: string; }[]

;
result: {} | unknown[] | string;
success: true;
} & { result?:

TunnelCfdTunnel

A Cloudflare Tunnel that connects your origin to Cloudflare's edge.

interface TunnelCfdTunnel {
account_tag?: TunnelAccountId;
config_src?: TunnelConfigSrc;
connections?: TunnelConnectionsDeprecated;
conns_active_at?: TunnelConnsActiveAt;
conns_inactive_at?: TunnelConnsInactiveAt;
created_at?: TunnelCreatedAt;
deleted_at?: TunnelDeletedAt;
id?: TunnelTunnelId;
metadata?: TunnelMetadata;
name?: TunnelTunnelName;
remote_config?: TunnelRemoteConfig;
status?: TunnelStatus;
tun_type?: TunnelTunnelType;
}

TunnelWarpConnectorTunnel

A Warp Connector Tunnel that connects your origin to Cloudflare's edge.

interface TunnelWarpConnectorTunnel {
account_tag?: TunnelAccountId;
connections?: TunnelConnectionsDeprecated;
conns_active_at?: TunnelConnsActiveAt;
conns_inactive_at?: TunnelConnsInactiveAt;
created_at?: TunnelCreatedAt;
deleted_at?: TunnelDeletedAt;
id?: TunnelTunnelId;
metadata?: TunnelMetadata;
name?: TunnelTunnelName;
status?: TunnelStatus;
tun_type?: TunnelTunnelType;
}

; }

Client Errors

4XX application/json

Get a Cloudflare Tunnel response failure

type TunnelTunnelResponseSingle = interface TunnelApiResponseCommon {
errors:

TunnelMessages

type TunnelMessages = { code: number;message: string; }[]

;
messages:

TunnelMessages

type TunnelMessages = { code: number;message: string; }[]

;
result: {} | unknown[] | string;
success: true;
} & { result?:

TunnelCfdTunnel

A Cloudflare Tunnel that connects your origin to Cloudflare's edge.

TunnelWarpConnectorTunnel

A Warp Connector Tunnel that connects your origin to Cloudflare's edge.

; } & interface TunnelApiResponseCommonFailure {
errors:

TunnelMessages

type TunnelMessages = { code: number;message: string; }[]

;
messages:

TunnelMessages

type TunnelMessages = { code: number;message: string; }[]

;
result: null;
success: false;
}