---
title: Traceroutes
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/typescript)

[Diagnostics](https://developers.cloudflare.com/api/typescript/resources/diagnostics)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Traceroutes

##### [Traceroute](https://developers.cloudflare.com/api/typescript/resources/diagnostics/subresources/traceroutes/methods/create)

client.diagnostics.traceroutes.create(TracerouteCreateParams { account\_id, targets, colos, options } params, RequestOptionsoptions?): SinglePage<[Traceroute](https://developers.cloudflare.com/api/typescript/resources/diagnostics#%28resource%29%20diagnostics.traceroutes%20%3E%20%28model%29%20traceroute%20%3E%20%28schema%29) { colos, target } \>

POST/accounts/{account\_id}/diagnostics/traceroute

##### ModelsExpand Collapse 

Traceroute { colos, target } 

colos?: Array<Colo\>

colo?: Colo { city, name } 

city?: string

Source colo city.

name?: string

Source colo name.

error?: "" | "Could not gather traceroute data: Code 1" | "Could not gather traceroute data: Code 2" | 2 more

Errors resulting from collecting traceroute from colo to target.

One of the following:

""

"Could not gather traceroute data: Code 1"

"Could not gather traceroute data: Code 2"

"Could not gather traceroute data: Code 3"

"Could not gather traceroute data: Code 4"

hops?: Array<Hop\>

nodes?: Array<Node\>

An array of node objects.

asn?: string

AS number associated with the node object.

ip?: string

IP address of the node.

labels?: Array<string\>

Field appears if there is an additional annotation printed when the probe returns. Field also appears when running a GRE+ICMP traceroute to denote which traceroute a node comes from.

max\_rtt\_ms?: number

Maximum RTT in ms.

mean\_rtt\_ms?: number

Mean RTT in ms.

min\_rtt\_ms?: number

Minimum RTT in ms.

name?: string

Host name of the address, this may be the same as the IP address.

packet\_count?: number

Number of packets with a response from this node.

std\_dev\_rtt\_ms?: number

Standard deviation of the RTTs in ms.

packets\_lost?: number

Number of packets where no response was received.

packets\_sent?: number

Number of packets sent with specified TTL.

packets\_ttl?: number

The time to live (TTL).

target\_summary?: unknown

Aggregated statistics from all hops about the target.

traceroute\_time\_ms?: number

Total time of traceroute in ms.

target?: string

The target hostname, IPv6, or IPv6 address.