Qodex.ai

Get network test results

GET {{baseUrl}}/test-results/:testId/network?aid=1234&window=12h&startDate=2022-07-17T22:00:54Z&endDate=2022-07-18T22:00:54Z&cursor=&direction=to-target

Returns network test results for every agent and round. If you do not specify a window or a start and end date, data is displayed for the most recent testing round.

Request Params

KeyDatatypeRequiredDescription
aidnumberA unique identifier associated with your account group. You can retrieve your AccountGroupId from the /account-groups endpoint. Note that you must be assigned to the target account group. Specifying this parameter without being assigned to the target account group will result in an error response.
windowstringA dynamic time interval up to the current time of the request. Specify the interval as a number followed by an optional type: s for seconds (default if no type is specified), m for minutes, h for hours, d for days, and w for weeks.
For a precise date range, use startDate and endDate.
startDatestringUse with the endDate parameter. Include the complete time (hours, minutes, and seconds) in UTC time zone, following the ISO 8601 date-time format. See the example for reference. Please note that this parameter can't be used with window.
endDatestringDefaults to current time the request is made. Use with the startDate parameter. Include the complete time (hours, minutes, and seconds) in UTC time zone, following the ISO 8601 date-time format. See the example for reference. Please note that this parameter can't be used with window.
cursornull(Optional) Opaque cursor used for pagination. Clients should use next value from _links instead of this parameter.
directionstringChoose the direction for the metrics you want: [from-target, to-target, bidirectional]. This applies when you're doing bidirectional Agent-to-Agent tests. For bidirectional data, you'll get combined results; otherwise, you'll get data for one direction. If you try to get unidirectional test data with an incorrect direction parameter, it will trigger an error response.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"results":[{"availableBandwidth":9.100464,"avgLatency":167.04,"bandwidth":4.3313155,"capacity":210.10854,"jitter":0.076808,"loss":0,"maxLatency":168,"minLatency":167,"packetsBySecond":[[],[0],[2],[2,1],[1,1]],"agent":{"agentId":"281474976710706","agentName":"thousandeyes-stg-va-254","countryId":"US","location":"San Francisco Bay Area"},"date":"2022-07-17T22:00:54Z","roundId":1384309800,"serverIp":"50.18.127.223","server":"www.thousandeyes.com:80","healthScore":0.98,"direction":"to-target","_links":{"appLink":{"href":"https://app.thousandeyes.com/view/tests?__a=105\u0026testId=195\u0026roundId=1692916680\u0026agentId=125"}},"startTime":1384309800,"endTime":1384309800},{"availableBandwidth":9.100464,"avgLatency":167.04,"bandwidth":4.3313155,"capacity":210.10854,"jitter":0.076808,"loss":0,"maxLatency":168,"minLatency":167,"packetsBySecond":[[],[0],[2],[2,1],[1,1]],"agent":{"agentId":"281474976710706","agentName":"thousandeyes-stg-va-254","countryId":"US","location":"San Francisco Bay Area"},"date":"2022-07-17T22:00:54Z","roundId":1384309800,"serverIp":"50.18.127.223","server":"www.thousandeyes.com:80","healthScore":0.98,"direction":"to-target","_links":{"appLink":{"href":"https://app.thousandeyes.com/view/tests?__a=105\u0026testId=195\u0026roundId=1692916680\u0026agentId=125"}},"startTime":1384309800,"endTime":1384309800}],"test":{"interval":60,"alertsEnabled":true,"enabled":true,"createdBy":"user@user.com","createdDate":"2022-07-17T22:00:54Z","description":"ThousandEyes Test","liveShare":false,"modifiedBy":"user@user.com","modifiedDate":"2022-07-17T22:00:54Z","savedEvent":true,"testId":"281474976710706","testName":"ThousandEyes Test","type":"agent-to-server","_links":{"self":{"href":"https://api.thousandeyes.com/v7/tests/{type}/281474976710706"},"testResults":[{"href":"https://api.thousandeyes.com/v7/test-results/281474976710706/network"},{"href":"https://api.thousandeyes.com/v7/test-results/281474976710706/path-vis"}]}},"startDate":"2022-07-17T22:00:54Z","endDate":"2022-07-18T22:00:54Z","_links":{"previous":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":true,"type":"anim elit Lorem","deprecation":"adipisicing","name":"ullamco","profile":"ea dolor","title":"ut anim officia eiusmod","hreflang":"velit est officia non"},"next":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"amet ut","deprecation":"ex ut in ad reprehenderit","name":"in officia reprehenderit eiusmod","profile":"vel","title":"minim esse occaecat deserunt","hreflang":"aliqua Excepteur"},"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"do labore ea mollit","deprecation":"reprehen","name":"nisi fugiat","profile":"aute ex","title":"ea Ut","hreflang":"cillum"}}}