--- title: Diagnostics --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Diagnostics #### DiagnosticsTraceroutes ##### [Traceroute](https://developers.cloudflare.com/api/python/resources/diagnostics/subresources/traceroutes/methods/create) diagnostics.traceroutes.create(TracerouteCreateParams\*\*kwargs) -> SyncSinglePage\[[Traceroute]()] POST/accounts/{account\_id}/diagnostics/traceroute ##### ModelsExpand Collapse
class Traceroute: …
colos: Optional\[List\[Colo]]
colo: Optional\[ColoColo] city: Optional\[str] Source colo city. Link to this property name: Optional\[str] Source colo name. Link to this property
Link to this property
error: Optional\[Literal\["", "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: Optional\[List\[ColoHop]]
nodes: Optional\[List\[ColoHopNode]] An array of node objects. asn: Optional\[str] AS number associated with the node object. Link to this property ip: Optional\[str] IP address of the node. Link to this property labels: Optional\[List\[str]] 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: Optional\[float] Maximum RTT in ms. Link to this property mean\_rtt\_ms: Optional\[float] Mean RTT in ms. Link to this property min\_rtt\_ms: Optional\[float] Minimum RTT in ms. Link to this property name: Optional\[str] Host name of the address, this may be the same as the IP address. Link to this property packet\_count: Optional\[int] Number of packets with a response from this node. Link to this property std\_dev\_rtt\_ms: Optional\[float] Standard deviation of the RTTs in ms. Link to this property
Link to this property packets\_lost: Optional\[int] Number of packets where no response was received. Link to this property packets\_sent: Optional\[int] Number of packets sent with specified TTL. Link to this property packets\_ttl: Optional\[int] The time to live (TTL). Link to this property
Link to this property target\_summary: Optional\[object] Aggregated statistics from all hops about the target. Link to this property traceroute\_time\_ms: Optional\[int] Total time of traceroute in ms. Link to this property
Link to this property target: Optional\[str] 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)>) #### DiagnosticsEndpoint Healthchecks ##### [List Endpoint Health Checks](https://developers.cloudflare.com/api/python/resources/diagnostics/subresources/endpoint-healthchecks/methods/list) diagnostics.endpoint\_healthchecks.list(EndpointHealthcheckListParams\*\*kwargs) -> [EndpointHealthcheckListResponse]() GET/accounts/{account\_id}/diagnostics/endpoint-healthchecks ##### [Endpoint Health Check](https://developers.cloudflare.com/api/python/resources/diagnostics/subresources/endpoint-healthchecks/methods/create) diagnostics.endpoint\_healthchecks.create(EndpointHealthcheckCreateParams\*\*kwargs) -> [EndpointHealthcheckCreateResponse]() POST/accounts/{account\_id}/diagnostics/endpoint-healthchecks ##### [Get Endpoint Health Check](https://developers.cloudflare.com/api/python/resources/diagnostics/subresources/endpoint-healthchecks/methods/get) diagnostics.endpoint\_healthchecks.get(strid, EndpointHealthcheckGetParams\*\*kwargs) -> [EndpointHealthcheckGetResponse]() GET/accounts/{account\_id}/diagnostics/endpoint-healthchecks/{id} ##### [Delete Endpoint Health Check](https://developers.cloudflare.com/api/python/resources/diagnostics/subresources/endpoint-healthchecks/methods/delete) diagnostics.endpoint\_healthchecks.delete(strid, EndpointHealthcheckDeleteParams\*\*kwargs) -> [EndpointHealthcheckDeleteResponse]() DELETE/accounts/{account\_id}/diagnostics/endpoint-healthchecks/{id} ##### [Update Endpoint Health Check](https://developers.cloudflare.com/api/python/resources/diagnostics/subresources/endpoint-healthchecks/methods/update) diagnostics.endpoint\_healthchecks.update(strid, EndpointHealthcheckUpdateParams\*\*kwargs) -> [EndpointHealthcheckUpdateResponse]() PUT/accounts/{account\_id}/diagnostics/endpoint-healthchecks/{id} ##### ModelsExpand Collapse
class EndpointHealthcheck: … check\_type: Literal\["icmp"] type of check to perform Link to this property endpoint: str the IP address of the host to perform checks against Link to this property name: Optional\[str] Optional name associated with this check Link to this property
[Link to this property](<#(resource)%20diagnostics.endpoint-healthchecks%20%3E%20(model)%20endpoint_healthcheck%20%3E%20(schema)>)
class EndpointHealthcheckListResponse: … check\_type: Literal\["icmp"] type of check to perform Link to this property endpoint: str the IP address of the host to perform checks against Link to this property id: Optional\[str] UUID. maxLength36 Link to this property name: Optional\[str] Optional name associated with this check Link to this property
[Link to this property](<#(resource)%20diagnostics.endpoint-healthchecks%20%3E%20(model)%20endpoint_healthcheck_list_response%20%3E%20(schema)>)
class EndpointHealthcheckCreateResponse: … check\_type: Literal\["icmp"] type of check to perform Link to this property endpoint: str the IP address of the host to perform checks against Link to this property id: Optional\[str] UUID. maxLength36 Link to this property name: Optional\[str] Optional name associated with this check Link to this property
[Link to this property](<#(resource)%20diagnostics.endpoint-healthchecks%20%3E%20(model)%20endpoint_healthcheck_create_response%20%3E%20(schema)>)
class EndpointHealthcheckGetResponse: … check\_type: Literal\["icmp"] type of check to perform Link to this property endpoint: str the IP address of the host to perform checks against Link to this property id: Optional\[str] UUID. maxLength36 Link to this property name: Optional\[str] Optional name associated with this check Link to this property
[Link to this property](<#(resource)%20diagnostics.endpoint-healthchecks%20%3E%20(model)%20endpoint_healthcheck_get_response%20%3E%20(schema)>)
class EndpointHealthcheckDeleteResponse: …
errors: List\[Error] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[ErrorSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property
messages: List\[Message] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[MessageSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property success: Literal\[true] Whether the API call was successful. Link to this property
[Link to this property](<#(resource)%20diagnostics.endpoint-healthchecks%20%3E%20(model)%20endpoint_healthcheck_delete_response%20%3E%20(schema)>)
class EndpointHealthcheckUpdateResponse: … check\_type: Literal\["icmp"] type of check to perform Link to this property endpoint: str the IP address of the host to perform checks against Link to this property id: Optional\[str] UUID. maxLength36 Link to this property name: Optional\[str] Optional name associated with this check Link to this property
[Link to this property](<#(resource)%20diagnostics.endpoint-healthchecks%20%3E%20(model)%20endpoint_healthcheck_update_response%20%3E%20(schema)>)