--- title: Traceroutes --- [Skip to content](#_top) [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]() {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. Link to this property name?: string Source colo name. Link to this property
Link to this property
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: "" Link to this property "Could not gather traceroute data: Code 1" Link to this property "Could not gather traceroute data: Code 2" Link to this property "Could not gather traceroute data: Code 3" Link to this property "Could not gather traceroute data: Code 4" Link to this property
Link to this property
hops?: Array<Hop>
nodes?: Array<Node> An array of node objects. asn?: string AS number associated with the node object. Link to this property ip?: string IP address of the node. Link to this property 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. Link to this property max\_rtt\_ms?: number Maximum RTT in ms. Link to this property mean\_rtt\_ms?: number Mean RTT in ms. Link to this property min\_rtt\_ms?: number Minimum RTT in ms. Link to this property name?: string Host name of the address, this may be the same as the IP address. Link to this property packet\_count?: number Number of packets with a response from this node. Link to this property std\_dev\_rtt\_ms?: number Standard deviation of the RTTs in ms. Link to this property
Link to this property packets\_lost?: number Number of packets where no response was received. Link to this property packets\_sent?: number Number of packets sent with specified TTL. Link to this property packets\_ttl?: number The time to live (TTL). Link to this property
Link to this property target\_summary?: unknown Aggregated statistics from all hops about the target. Link to this property traceroute\_time\_ms?: number Total time of traceroute in ms. Link to this property
Link to this property target?: string The target hostname, IPv6, or IPv6 address. Link to this property
[Link to this property](<#(resource)%20diagnostics.traceroutes%20%3E%20(model)%20traceroute%20%3E%20(schema)>)