{"type":"api","title":"Traceroute Device","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/d2f02ba2-fd0d-3a26-bcc5-feafc8f24d17","info":{"title":"Monitoring and Troubleshooting","description":"Includes API operations for the following:\n- Real-time monitoring\n- Accessing statistics APIs and statistics bulk APIs\n- Retrieving device state\n- Managing alarms and events\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Troubleshooting Tools - Device Connectivity"],"description":"Traceroute","operationId":"tracerouteDevice","parameters":[{"name":"deviceIP","in":"path","description":"Device IP","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Traceroute parameter","content":{"application/json":{"schema":{"type":"object","properties":{"deviceIp":{"type":"string","example":"172.16.255.15"},"host":{"type":"string","example":"3::2"},"interface":{"type":"string","example":"3::1"},"interfaceIP":{"type":"string","example":"3::1"},"size":{"type":"string","example":"128"},"vpn":{"type":"string","example":"0"}},"$$ref":"#/components/schemas/TracerouteRequest"},"examples":{"Traceroute parameter":{"description":"Traceroute parameter","value":{"deviceIp":"172.16.255.15","host":"10.1.12.16","interface":"10.1.12.15","interfaceIP":"10.1.12.15","vpn":"0"}}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"nexthops":{"type":"array","items":{"type":"object","properties":{"errorInfo":{"type":"string","example":"Host unreachable"},"hopName":{"type":"string"},"hopNumber":{"type":"string","example":"1"},"ipAddress":{"type":"string","example":"3::2"},"meanLatency":{"type":"string","example":"1.269"}},"$$ref":"#/components/schemas/Hops"}},"rawOutput":{"type":"array","items":{"type":"string"}}},"$$ref":"#/components/schemas/TracerouteResponse"}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"x-roles-required":"Tools-read","method":"post","path":"/device/tools/traceroute/{deviceIP}"}}