Test Results

DNS

DNSSEC

v6

v7

GET /v6/dns/dnssec/{testId}.json

GET /v7/test-results/{testId}/dnssec

Response Body

{

    "from": "2025-04-21 01:06:11",

    "to": "2025-04-21 13:06:11",

    "dns": {

        "test": {

            "interval": 300,

            "testId": 6952562,

            "liveShare": 0,

            "testName": "internetsociety.org DNSSEC",

            "createdBy": "API User (demo@thousandeyes.com)

            "createdDate": "2025-04-21 13:01:34",

            "type": "dns-dnssec",

            "alertsEnabled": 1,

            "enabled": 1,

            "dnsQueryClass": "IN",

            "domain": "internetsociety.org A",

            "randomizedStartTime": 0,

            "savedEvent": 0,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/6952562"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/dns/dnssec/6952562"

                }

            ],

            "subinterval": -1

        },

        "dnssec": [

            {

                "agentId": 1438098,

                "agentName": "Nashville-Agent01",

                "countryId": "US",

                "valid": 1,

                "date": "2025-04-21 13:01:39",

                "roundId": 1745240400,

                "startTime": 1745240499,

                "endTime": 1745240499,

                "permalink": "https://app.thousandeyes.com/dns/dnssec?__a=2067002&testId=6952562&roundId=1745240400&serverId=0&agentId=1438098"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-21T01:06:05Z",

    "endDate": "2025-04-21T13:06:05Z",

    "test": {

        "interval": 300,

        "testId": "6952562",

        "liveShare": false,

        "testName": "internetsociety.org DNSSEC",

        "createdBy": "API User (demo@thousandeyes.com)",

        "createdDate": "2025-04-21T13:01:34Z",

        "type": "dnssec",

        "alertsEnabled": true,

        "enabled": true,

        "dnsQueryClass": "in",

        "domain": "internetsociety.org A",

        "randomizedStartTime": false,

        "savedEvent": false,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/dnssec/6952562"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6952562/dnssec"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "1438098",

                "agentName": "Nashville-Agent01",

                "countryId": "US"

            },

            "isValid": true,

            "date": "2025-04-21T13:01:39Z",

            "roundId": 1745240400,

            "startTime": 1745240499,

            "endTime": 1745240499,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/dns/dnssec?__a=2067002&testId=6952562&roundId=1745240400&serverId=0&agentId=1438098"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/6952562/dnssec"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `dns` property to a top-level `test` property. Within the `test` property:

·       The ` testId` field has changed from an integer to string

·       The ` alertsEnabled`, `liveShare`, `enabled`, `savedEvent`, and `randomizedStartTime` fields have changed from integer to boolean.

·       The value of the ` dnsQueryClass` property is now lowercase.

·       The `apiLinks` property has been replaced with the `_links` property.

·       The value for the `type` field has changed from "dns-dnssec" to "dnssec".

·       The `subinterval` field has been removed.

5.  The `dnssec` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The `valid` property has been renamed `isValid`, and its type has changed from integer to boolean.

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

DNS Server Metrics

v6

v7

GET /v6/dns/server/{testId}.json

GET /v7/test-results/{testId}/dns-server

Response Body

{

    "dns": {

        "test": {

            "createdDate": "2025-01-08 21:02:34",

            "modifiedDate": "2025-01-24 20:31:14",

            "createdBy": "API User (demo@ thousandeyes.com)",

            "modifiedBy": "API User (demo@ thousandeyes.com)",

            "testId": 6335944,

            "testName": "MS365 Login External",

            "type": "dns-server",

            "interval": 300,

            "randomizedStartTime": 0,

            "domain": "login.microsoftonline.com CNAME",

            "dnsQueryClass": "IN",

            "protocol": "TCP",

            "dnsTransportProtocol": "UDP",

            "ipv6Policy": "USE_AGENT_POLICY",

            "networkMeasurements": 1,

            "mtuMeasurements": 1,

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 1,

            "usePublicBgp": 1,

            "alertsEnabled": 1,

            "liveShare": 0,

            "recursiveQueries": 0,

            "probeMode": "AUTO",

            "pathTraceMode": "classic",

            "savedEvent": 0,

            "enabled": 1,

            "numPathTraces": 1,

            "continuousMode": 0,

            "subinterval": -1,

            "dnsServers": [

                {

                    "serverId": 1123206,

                    "serverName": "ns1-38.azure-dns.com."

                },

                {

                    "serverId": 1123209,

                    "serverName": "ns2-38.azure-dns.net."

                }

            ],

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/6335944"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/dns/server/6335944"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/6335944"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/6335944"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/6335944"

                }

            ]

        },

        "server": [

            {

                "time": 35,

                "agentId": 3,

                "agentName": "Singapore",

                "countryId": "SG",

                "date": "2025-04-21 13:30:46",

                "roundId": 1745242200,

                "startTime": 1745242242,

                "endTime": 1745242246,

                "serverId": 1123206,

                "server": "ns1-38.azure-dns.com.",

                "resolutionTime": 35,

                "mappings": "login.mso.msidentity.com.",

                "permalink": "https://app.thousandeyes.com/dns/server?__a=2067002&testId=6335944&roundId=1745242200&serverId=1123206&agentId=3"

            },

            {

                "time": 33,

                "agentId": 3,

                "agentName": "Singapore",

                "countryId": "SG",

                "date": "2025-04-21 13:30:29",

                "roundId": 1745242200,

                "startTime": 1745242227,

                "endTime": 1745242229,

                "serverId": 1123209,

                "server": "ns2-38.azure-dns.net.",

                "resolutionTime": 33,

                "mappings": "login.mso.msidentity.com.",

                "permalink": "https://app.thousandeyes.com/dns/server?__a=2067002&testId=6335944&roundId=1745242200&serverId=1123209&agentId=3"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "test": {

        "createdDate": "2025-01-08T21:02:34Z",

        "modifiedDate": "2025-01-24T20:31:14Z",

        "createdBy": "API User (demo@thousandeyes.com)",

        "modifiedBy": "API User (demo@ thousandeyes.com)",

        "testId": "6335944",

        "testName": "MS365 Login External",

        "type": "dns-server",

        "interval": 300,

        "randomizedStartTime": false,

        "domain": "login.microsoftonline.com CNAME",

        "dnsQueryClass": "in",

        "protocol": "tcp",

        "dnsTransportProtocol": "udp",

        "ipv6Policy": "use-agent-policy",

        "networkMeasurements": true,

        "mtuMeasurements": true,

        "bandwidthMeasurements": false,

        "bgpMeasurements": true,

        "usePublicBgp": true,

        "alertsEnabled": true,

        "liveShare": false,

        "recursiveQueries": false,

        "probeMode": "auto",

        "pathTraceMode": "classic",

        "savedEvent": false,

        "enabled": true,

        "numPathTraces": 1,

        "dnsServers": [

            {

                "serverId": "1123206",

                "serverName": "ns1-38.azure-dns.com."

            },

            {

                "serverId": "1123209",

                "serverName": "ns2-38.azure-dns.net."

            }

        ],

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/dns-server/6335944"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6335944/dns-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6335944/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6335944/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6335944/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "3",

                "agentName": "Singapore",

                "countryId": "SG"

            },

            "date": "2025-04-21T13:30:46Z",

            "roundId": 1745242200,

            "resolutionTime": 35,

            "serverId": "1123206",

            "server": "ns1-38.azure-dns.com.",

            "mappings": "login.mso.msidentity.com.",

            "startTime": 1745242242,

            "endTime": 1745242246,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/dns/server?__a=2067002&testId=6335944&roundId=1745242200&serverId=1123206&agentId=3"

                }

            }

        },

        {

            "agent": {

                "agentId": "3",

                "agentName": "Singapore",

                "countryId": "SG"

            },

            "date": "2025-04-21T13:30:29Z",

            "roundId": 1745242200,

            "resolutionTime": 33,

            "serverId": "1123209",

            "server": "ns2-38.azure-dns.net.",

            "mappings": "login.mso.msidentity.com.",

            "startTime": 1745242227,

            "endTime": 1745242229,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/dns/server?__a=2067002&testId=6335944&roundId=1745242200&serverId=1123209&agentId=3"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/6335944/dns-server"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `dns` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId` and `serverId` properties have changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `networkMeasurements`, `mtuMeasurements`, `bandwidthMeasurements`, `bgpMeasurements`, `usePublicBgp`, `alertsEnabled`, `liveShare`, `recursiveQueries`, `savedEvent`, `enabled`, and `randomizedStartTime` properties has changed from integer to boolean.

·       The `apiLinks` property has been replaced with the `_links` property.

·       The `continuousMode` and `subinterval` properties have been removed.

·       The values of the ` dnsQueryClass`, `protocol`, `dnsTransportProtocol`, `ipv6Policy`, and `probeMode` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was " USE_AGENT_POLICY", in v7 it is "use-agent-policy"

5.  The `server` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

·       The value of the `serverId` property has changed from integer to string.

·       The `time` property has been removed. The `resolutionTime` property can be used instead.

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

DNS Server Metrics by Server

v6

v7

GET /v6/dns/server/{testId}/{serverId}.json

GET /v7/test-results/{testId}/dns-server/{serverId}

Response Body

{

    "from": "2025-04-21 02:33:12",

    "to": "2025-04-21 14:33:12",

    "dns": {

        "test": {

            "createdDate": "2025-01-08 21:02:34",

            "modifiedDate": "2025-01-24 20:31:14",

            "createdBy": "API User (demo@cisco.com)",

            "modifiedBy": "API User (demo@cisco.com)",

            "testId": 6335944,

            "testName": "MS O365 Login External",

            "type": "dns-server",

            "interval": 300,

            "randomizedStartTime": 0,

            "domain": "login.microsoftonline.com CNAME",

            "dnsQueryClass": "IN",

            "protocol": "TCP",

            "dnsTransportProtocol": "UDP",

            "ipv6Policy": "USE_AGENT_POLICY",

            "networkMeasurements": 1,

            "mtuMeasurements": 1,

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 1,

            "usePublicBgp": 1,

            "alertsEnabled": 1,

            "liveShare": 0,

            "recursiveQueries": 0,

            "probeMode": "AUTO",

            "pathTraceMode": "classic",

            "numPathTraces": 1,

            "enabled": 1,

            "savedEvent": 0,

            "continuousMode": 0,

            "subinterval": -1,

            "dnsServers": [

                {

                    "serverId": 1123206,

                    "serverName": "ns1-38.azure-dns.com."

                }

            ],

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/6335944"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/dns/server/6335944"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/6335944"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/6335944"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/6335944"

                }

            ]

        },

        "server": [

            {

                "time": 48,

                "agentId": 27665,

                "agentName": "Perth, Australia",

                "countryId": "AU",

                "date": "2025-04-21 14:15:02",

                "roundId": 1745244900,

                "startTime": 1745244900,

                "endTime": 1745244902,

                "serverId": 1123206,

                "server": "ns1-38.azure-dns.com.",

                "resolutionTime": 48,

                "mappings": "login.mso.msidentity.com.",

                "permalink": "https://app.thousandeyes.com/dns/server?__a=2067002&testId=6335944&roundId=1745244900&serverId=1123206&agentId=27665"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

        "startDate": "2025-04-21T02:33:15Z",

    "endDate": "2025-04-21T14:33:15Z",

    "test": {

        "createdDate": "2025-01-08T21:02:34Z",

        "modifiedDate": "2025-01-24T20:31:14Z",

        "createdBy": "API User (demo@cisco.com)",

        "modifiedBy": "API User (demo@cisco.com)",

        "testId": "6335944",

        "testName": "MS O365 Login External",

        "type": "dns-server",

        "interval": 300,

        "randomizedStartTime": false,

        "domain": "login.microsoftonline.com CNAME",

        "dnsQueryClass": "in",

        "protocol": "tcp",

        "dnsTransportProtocol": "udp",

        "ipv6Policy": "use-agent-policy",

        "networkMeasurements": true,

        "mtuMeasurements": true,

        "bandwidthMeasurements": false,

        "bgpMeasurements": true,

        "usePublicBgp": true,

        "alertsEnabled": true,

        "liveShare": false,

        "recursiveQueries": false,

        "probeMode": "auto",

        "pathTraceMode": "classic",

        "numPathTraces": 1,

        "enabled": true,

        "savedEvent": false,

        "dnsServers": [

            {

                "serverId": "1123206",

                "serverName": "ns1-38.azure-dns.com."

            }

        ],

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/dns-server/6335944"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6335944/dns-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6335944/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6335944/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6335944/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "27665",

                "agentName": "Perth, Australia",

                "countryId": "AU"

            },

            "date": "2025-04-21T14:15:02Z",

            "roundId": 1745244900,

            "startTime": 1745244900,

            "endTime": 1745244902,

            "serverId": "1123206",

            "server": "ns1-38.azure-dns.com.",

            "resolutionTime": 48,

            "mappings": "login.mso.msidentity.com.",

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/dns/server?__a=2067002&testId=6335944&roundId=1745244900&serverId=1123206&agentId=27665"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/6335944/dns-server/1123206"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `dns` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId` and `serverId` properties have changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `networkMeasurements`, `mtuMeasurements`, `bandwidthMeasurements`, `bgpMeasurements`, `usePublicBgp`, `alertsEnabled`, `liveShare`, `recursiveQueries`, `savedEvent`, `enabled`, and `randomizedStartTime` properties has changed from integer to boolean.

·       The `apiLinks` property has been replaced with the `_links` property.

·       The `continuousMode` and `subinterval` properties have been removed.

·       The values of the ` dnsQueryClass`, `protocol`, `dnsTransportProtocol`, `ipv6Policy`, and `probeMode` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was " USE_AGENT_POLICY", in v7 it is "use-agent-policy"

5.  The `server` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

·       The value of the `serverId` property has changed from integer to string.

·       The `time` property has been removed. The `resolutionTime` property can be used instead.

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

Domain trace

v6

v7

GET /v6/dns/trace/{testId}.json

GET /v7/test-results/{testId}/dns-trace

Response Body

{

    "from": "2025-04-21 13:44:56",

    "to": "2025-04-21 14:44:56",

    "dns": {

        "test": {

            "createdDate": "2024-07-31 15:51:06",

            "modifiedDate": "2025-01-08 20:55:14",

            "createdBy": "Demo User (api@thousandeyes.com)",

            "modifiedBy": " Demo User (api@thousandeyes.com)",

            "testId": 5676741,

            "testName": "MSTeams - MS Teams TR - DNS - External",

            "type": "dns-trace",

            "interval": 300,

            "randomizedStartTime": 0,

            "domain": "worldaz.tr.teams.microsoft.com CNAME",

            "dnsQueryClass": "IN",

            "dnsTransportProtocol": "UDP",

            "alertsEnabled": 1,

            "liveShare": 0,

            "enabled": 1,

            "savedEvent": 0,

            "subinterval": -1,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5676741"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/dns/trace/5676741"

                }

            ]

        },

        "trace": [

            {

                "agentId": 8416,

                "agentName": "Cork, Ireland",

                "countryId": "IE",

                "mappings": "worldaz.relay.teams.microsoft.com.",

                "output": "...",

                "queries": 4,

                "finalQueryTime": 20,

                "failedQueries": 0,

                "finalServerQueried": "ns1-39.azure-dns.com.",

                "date": "2025-04-21 13:45:09",

                "roundId": 1745243100,

                "startTime": 1745243109,

                "endTime": 1745243109,

                "permalink": "https://app.thousandeyes.com/dns/trace?__a=2067002&testId=5676741&roundId=1745243100&serverId=0&agentId=8416"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-21T13:45:07Z",

    "endDate": "2025-04-21T14:45:07Z",

    "test": {

        "createdDate": "2024-07-31T15:51:06Z",

        "modifiedDate": "2025-01-08T20:55:14Z",

        "createdBy": " Demo User (api@thousandeyes.com)",

        "modifiedBy": " Demo User (api@thousandeyes.com)",

        "testId": "5676741",

        "testName": "MSTeams - MS Teams TR - DNS - External",

        "type": "dns-trace",

        "interval": 300,

        "randomizedStartTime": false,

        "domain": "worldaz.tr.teams.microsoft.com CNAME",

        "dnsQueryClass": "in",

        "dnsTransportProtocol": "udp",

        "alertsEnabled": true,

        "liveShare": false,

        "enabled": true,

        "savedEvent": false,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/dns-trace/5676741"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5676741/dns-trace"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "8416",

                "agentName": "Cork, Ireland",

                "countryId": "IE"

            },

            "mappings": "worldaz.relay.teams.microsoft.com.",

            "output": "...",

            "queries": 4,

            "finalQueryTime": 20,

            "failedQueries": 0,

            "finalServerQueried": "ns1-39.azure-dns.com.",

            "date": "2025-04-21T13:45:09Z",

            "roundId": 1745243100,

            "startTime": 1745243109,

            "endTime": 1745243109,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/dns/trace?__a=2067002&testId=5676741&roundId=1745243100&serverId=0&agentId=8416"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5676741/dns-trace?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `dns` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId` property has changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, `liveShare`, `savedEvent`, `enabled`, and `randomizedStartTime` properties have changed from integer to boolean.

·       The values of the ` dnsQueryClass`, and `dnsTransportProtocol` properties are now lowercase, and underscores are replaced with hyphens.

·       The `subinterval` field has been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

5.  The `trace` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

 

Network

BGP Metrics

v6

v7

GET /v6/net/bgp-metrics/{testId}

GET /v7/test-results/{testId}/bgp

Response Body

{

    "from": "2025-04-24 12:33:22",

    "to": "2025-04-24 13:33:22",

    "net": {

        "test": {

            "createdDate": "2025-01-13 15:12:53",

            "createdBy": "Demo User (demo@thousandeyes.com)",

            "modifiedDate": "2025-01-14 16:17:51",

            "modifiedBy": "Demo User (demo@thousandeyes.com)",

            "testId": 6356180,

            "testName": "RPKI Test",

            "type": "bgp",

            "prefix": "1.1.1.0/24",

            "usePublicBgp": 1,

            "alertsEnabled": 1,

            "liveShare": 0,

            "enabled": 1,

            "savedEvent": 0,

            "includeCoveredPrefixes": 0,

            "subinterval": -1,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/6356180"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/6356180"

                }

            ]

        },

        "bgpMetrics": [

            {

                "date": "2025-04-24 12:33:00",

                "countryId": "NG",

                "monitorId": 28940,

                "monitorName": "Lagos-2 - Melbicom (AS 8849)",

                "pathChanges": 0.0,

                "prefix": "1.1.1.0/24",

                "prefixId": 13522085,

                "reachability": 100.0,

                "roundId": 1745497980,

                "updates": 0.0,

                "permalink": "https://app.thousandeyes.com/net/bgp-vis?__a=null&testId=6356180&roundId=1745497980&prefixId=13522085"

            }

        ]

    },

    "pages": {

        "next": "https://api.thousandeyes.com/v6/net/bgp-metrics/6356180.json?lastRoundId=1745498520&from=2025-04-24+12%3A33%3A22&to=2025-04-24+13%3A33%3A22",

        "current": 1

    }

}

{

    "startDate": "2025-04-24T12:33:37Z",

    "endDate": "2025-04-24T13:33:37Z",

    "test": {

        "createdDate": "2025-01-13T15:12:53Z",

        "createdBy": "Demo User (demo@thousandeyes.com)",

        "modifiedDate": "2025-01-14T16:17:51Z",

        "modifiedBy": "Demo User (demo@thousandeyes.com)",

        "testId": "6356180",

        "testName": "RPKI Test",

        "type": "bgp",

        "prefix": "1.1.1.0/24",

        "usePublicBgp": true,

        "alertsEnabled": true,

        "liveShare": false,

        "enabled": true,

        "savedEvent": false,

        "includeCoveredPrefixes": false,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/bgp/6356180"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6356180/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "date": "2025-04-24T12:33:00Z",

            "monitor": {

                "countryId": "NG",

                "monitorId": "28940",

                "monitorName": "Lagos-2 - Melbicom (AS 8849)"

            },

            "pathChanges": 0.0,

            "prefix": "1.1.1.0/24",

            "prefixId": "13522085",

            "reachability": 100.0,

            "roundId": 1745497980,

            "updates": 0.0,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/net/bgp-vis?__a=null&testId=6356180&roundId=1745497980&prefixId=13522085"

                }

            }

        }

    ],

    "_links": {

        "next": {

            "href": "https://api.thousandeyes.com/v7/test-results/6356180/bgp?aid=2067002&cursor=bGFzdFJvdW5kSWQ9MTc0NTQ5ODUyMA==&startDate=2025-04-24T12:33:37Z&endDate=2025-04-24T13:33:37Z"

        },

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/6356180/bgp?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `net` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId` property has changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, `liveShare`, `savedEvent`, `enabled`, ` includeCoveredPrefixes` and `usePublicBgp` properties have changed from integer to boolean.

·       The `subinterval` field has been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

5.  The `bgpMetrics` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The monitor details, including `monitorName`, `countryId`, and `monitorId` are now grouped under the `monitor` property of each object in the `results` array. The `monitorId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone.

·       The value of the ` prefixId` property has changed from integer to string. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

BGP route information

v6

v7

GET /v6/net/bgp-routes/{testId}/{prefixId}/{roundId}

GET /v7/test-results/{testId}/bgp/routes/prefix/{prefixId}/round/{roundId}

Response Body

{

    "net": {

        "test": {

            "createdDate": "2025-01-13 15:12:53",

            "modifiedDate": "2025-04-24 14:00:37",

            "createdBy": "Demo User (demo@thousandeyes.com)",

            "modifiedBy": "Demo User (demo@thousandeyes.com)",

            "testId": 6356180,

            "testName": "RPKI Test",

            "type": "bgp",

            "enabled": 1,

            "savedEvent": 0,

            "prefix": "1.1.1.0/24",

            "usePublicBgp": 1,

            "alertsEnabled": 1,

            "liveShare": 0,

            "includeCoveredPrefixes": 0,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/6356180"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/6356180"

                }

            ],

            "subinterval": -1

        },

        "bgpRoutes": [

            {

                "countryId": "NL",

                "monitorId": 28906,

                "monitorName": "Amsterdam-52 - NL-IX (AS 34307)",

                "prefixId": 13522085,

                "prefix": "1.1.1.0/24",

                "active": 1,

                "date": "2025-04-24 12:33:00",

                "roundId": 1745497980,

                "hops": [

                    {

                        "asn": 50673,

                        "asName": "Serverius Holding B.V."

                    },

                    {

                        "asn": 12654,

                        "asName": "RIPE Network Coordination Center"

                    }

                ],

                "permalink": "https://app.thousandeyes.com/net/bgp-vis?__a=null&testId=null&roundId=1745497980&agentId=null"

            }

        ]

    }

}

{

    "test": {

        "createdDate": "2025-01-13T15:12:53Z",

        "modifiedDate": "2025-04-24T14:00:37Z",

        "createdBy": "Demo User (demo@thousandeyes.com)",

        "modifiedBy": "Demo User (demo@thousandeyes.com)",

        "testId": "6356180",

        "testName": "RPKI Test",

        "type": "bgp",

        "enabled": true,

        "savedEvent": false,

        "prefix": "1.1.1.0/24",

        "usePublicBgp": true,

        "alertsEnabled": true,

        "liveShare": false,

        "includeCoveredPrefixes": false,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/bgp/6356180"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6356180/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "monitor": {

                "countryId": "NL",

                "monitorId": "28906",

                "monitorName": "Amsterdam-52 - NL-IX (AS 34307)"

            },

            "prefixId": "13522085",

            "prefix": "1.1.1.0/24",

            "isActive": true,

            "date": "2025-04-24T12:33:00Z",

            "roundId": 1745497980,

            "hops": [

                {

                    "asn": 50673,

                    "asName": "Serverius Holding B.V."

                },

                {

                    "asn": 12654,

                    "asName": "RIPE Network Coordination Center"

                }

            ],

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/net/bgp-vis?__a=null&testId=null&roundId=1745497980&agentId=null"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/6356180/bgp/routes/prefix/13522085/round/1745497980"

        }

    }

}

Comments:

1.  The URL has changed.

2.  Test configuration details have moved from within the `net` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId` property has changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, `liveShare`, `savedEvent`, `enabled`, ` includeCoveredPrefixes` and `usePublicBgp` properties have changed from integer to boolean.

·       The `subinterval` field has been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

3.  The `bgpMetrics` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The monitor details, including `monitorName`, `countryId`, and `monitorId` are now grouped under the `monitor` property of each object in the `results` array. The `monitorId` value has changed from integer to string.

·       The `active` property has been renamed `isActive`, and its value has changed from integer to boolean.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone.

·       The value of the ` prefixId` property has changed from integer to string. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

 

End-to-End Metrics

v6

v7

GET /v6/net/metrics/{testId}

GET /v7/test-results/{testId}/network

Response Body

{

    "from": "2025-04-24 13:39:07",

    "to": "2025-04-24 14:39:07",

    "net": {

        "test": {

            "createdDate": "2024-07-31 15:51:03",

            "modifiedDate": "2025-01-08 18:07:27",

            "createdBy": "Demo User (demo@thousandeyes.com)",

            "modifiedBy": "Demo User (demo@thousandeyes.com)",

            "testId": 5676734,

            "testName": "MSTeams-Audio-Internal",

            "type": "agent-to-server",

            "interval": 300,

            "randomizedStartTime": 0,

            "server": "worldaz.tr.teams.microsoft.com:443",

            "protocol": "TCP",

            "ipv6Policy": "USE_AGENT_POLICY",

            "networkMeasurements": 1,

            "mtuMeasurements": 1,

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 1,

            "usePublicBgp": 1,

            "dscpId": 46,

            "dscp": "EF (DSCP 46)",

            "enabled": 1,

            "savedEvent": 0,

            "alertsEnabled": 1,

            "liveShare": 0,

            "pingPayloadSize": 1,

            "probeMode": "AUTO",

            "continuousMode": 0,

            "pathTraceMode": "classic",

            "numPathTraces": 3,

            "subinterval": -1,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5676734"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/5676734"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/5676734"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/5676734"

                }

            ]

        },

        "metrics": [

            {

                "agentId": 1355377,

                "agentName": "do-lon1-01",

                "countryId": "GB",

                "avgLatency": 8.0,

                "loss": 0.0,

                "maxLatency": 13.0,

                "jitter": 0.5104162,

                "minLatency": 8.0,

                "healthScore": 0.9973593,

                "serverIp": "52.114.253.246",

                "date": "2025-04-24 13:35:14",

                "roundId": 1745501700,

                "startTime": 1745501711,

                "endTime": 1745501714,

                "permalink": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5676734&roundId=1745501700&agentId=1355377"

            }

        ]    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-24T13:39:03Z",

    "endDate": "2025-04-24T14:39:03Z",

    "test": {

        "createdDate": "2024-07-31T15:51:03Z",

        "modifiedDate": "2025-01-08T18:07:27Z",

        "createdBy": "Demo User (demo@thousandeyes.com)",

        "modifiedBy": "Demo User (demo@thousandeyes.com)",

        "testId": "5676734",

        "testName": "MSTeams-Audio-Internal",

        "type": "agent-to-server",

        "interval": 300,

        "randomizedStartTime": false,

        "server": "worldaz.tr.teams.microsoft.com:443",

        "protocol": "tcp",

        "ipv6Policy": "use-agent-policy",

        "networkMeasurements": true,

        "mtuMeasurements": true,

        "bandwidthMeasurements": false,

        "bgpMeasurements": true,

        "usePublicBgp": true,

        "dscpId": "46",

        "dscp": "EF (DSCP 46)",

        "enabled": true,

        "savedEvent": false,

        "alertsEnabled": true,

        "liveShare": false,

        "pingPayloadSize": 1,

        "probeMode": "auto",

        "continuousMode": false,

        "pathTraceMode": "classic",

        "numPathTraces": 3,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/agent-to-server/5676734"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5676734/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5676734/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5676734/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "1355377",

                "agentName": "do-lon1-01",

                "countryId": "GB"

            },

            "avgLatency": 8.0,

            "loss": 0.0,

            "maxLatency": 13.0,

            "jitter": 0.5104162,

            "minLatency": 8.0,

            "healthScore": 0.9973593,

            "serverIp": "52.114.253.246",

            "date": "2025-04-24T13:35:14Z",

            "roundId": 1745501700,

            "startTime": 1745501711,

            "endTime": 1745501714,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5676734&roundId=1745501700&agentId=1355377"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5676734/network?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The values for the `direction` query parameter have changed from "FROM_TARGET", "TO_TARGET", and "BIDIRECTIONAL" to "from-target", "to-target", and "bidirectional". As in v6, this parameter only applies to Agent-to-Agent tests.

4.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

5.  Test configuration details have moved from within the `net` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId` property has changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, `liveShare`, `savedEvent`, `enabled`, `randomizedStartTime `, ` networkMeasurements `, ` mtuMeasurements`, ` bandwidthMeasurements`, ` bgpMeasurements`, ` usePublicBgp`,  and ` continuousMode` properties have changed from integer to boolean.

·       The value of the ` dscpId` field has changed from integer to string.

·       The values of the `protocol`, `ipv6Policy`, and `probeMode` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was "USE_AGENT_POLICY", in v7 it is "use-agent-policy"

·       The `subinterval` field has been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

6.  The `metrics` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

7.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

Detailed Path Trace

v6

v7

GET /v6/net/path-vis/{testId}/{agentId}/{roundId}

GET /v7/test-results/{testId}/path-vis/agent/{agentId}/round/{roundId}

Response Body

{

    "net": {

        "test": {

            ...

        },

        "pathVis": [

            {

                "server": "worldaz.tr.teams.microsoft.com:443",

                "serverIp": "52.114.229.2",

                "sourceIp": "134.209.26.24",

                "sourcePrefix": "134.209.16.0/20",

                "targetIsProxy": false,

                "agentId": 1355377,

                "agentName": "do-lon1-01",

                "countryId": "GB",

                "date": "2025-04-24 16:20:14",

                "roundId": 1745511600,

                "startTime": 1745511611,

                "endTime": 1745511614,

                "routes": [

                    {

                        "pathId": "12345678",

                        "hops": [

                            {

                                "hop": 10,

                                "ipAddress": "104.44.31.3",

                                "prefix": "104.40.0.0/13",

                                "rdns": "be-15-0.ibr02.ams30.ntwk.msn.net",

                                "responseTime": 31,

                                "location": "Amsterdam, Netherlands",

                                "mpls": "L=73629,E=0,S=0,T=1/L=22478,E=0,S=1,T=2",

                                "network": "Microsoft Corporation (AS 8075)"

                            }

                        ]

                    }       

                ],

                "permalink": "https://app.thousandeyes.com/net/path-vis?__a=2067002&testId=5676734&roundId=1745511600&serverId=943404&agentId=1355377"

            }

        ]

    }

}

{

    "test": {

        ...

    },

    "results": [

        {

            "server": "worldaz.tr.teams.microsoft.com:443",

            "serverIp": "52.114.229.2",

            "sourceIp": "134.209.26.24",

            "sourcePrefix": "134.209.16.0/20",

            "targetIsProxy": false,

            "agent": {

                "agentId": "1355377",

                "agentName": "do-lon1-01",

                "countryId": "GB"

            },

            "date": "2025-04-24T16:20:14Z",

            "roundId": 1745511600,

            "startTime": 1745511611,

            "endTime": 1745511614,

            "pathTraces": [

                {

                    "pathId": "12345678",

                    "hops": [

                        {

                            "hop": 10,

                            "ipAddress": "104.44.31.3",

                            "location": "Amsterdam, Netherlands",

                            "mpls": "L=73629,E=0,S=0,T=1/L=22478,E=0,S=1,T=2",

                            "network": "Microsoft Corporation (AS 8075)",

                            "prefix": "104.40.0.0/13",

                            "rdns": "be-15-0.ibr02.ams30.ntwk.msn.net",

                            "responseTime": 31

                        }

                    ]

                },

            ],

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/net/path-vis?__a=2067002&testId=5676734&roundId=1745511600&serverId=943404&agentId=1355377"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5676734/path-vis/agent/1355377/round/1745511600"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The values for the `direction` query parameter have changed from "FROM_TARGET", "TO_TARGET", and "BIDIRECTIONAL" to "from-target", "to-target". Omitting the parameter will default to the results from both "from-target" and "to-target" (bidirectional). As in v6, this parameter only applies to Agent-to-Agent tests.

3.  Test configuration details have moved from within the `net` property to a top-level `test` property. For detailed changes within the `test` property, see the "End-to-End Metrics" section above or refer to the "Tests" migration guide section.

4.  The ` pathVis` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

 

 

 

 

Path Visualization

v6

v7

GET /v6/net/path-vis/{testId}

GET /v7/test-results/{testId}/path-vis

Response Body

{

    "from": "2025-04-24 16:16:57",

    "to": "2025-04-24 17:16:57",

    "net": {

        "test": {

            ...

        },

        "pathVis": [

            {

                "agentId": 1355377,

                "agentName": "do-lon1-01",

                "countryId": "GB",

                "location": "England, United Kingdom",

                "server": "worldaz.tr.teams.microsoft.com:443",

                "serverIp": "52.114.229.2",

                "sourceIp": "134.209.26.24",

                "sourcePrefix": "134.209.16.0/20",

                "targetIsProxy": false,

                "date": "2025-04-24 16:20:14",

                "roundId": 1745511600,

                "startTime": 1745511611,

                "endTime": 1745511614,

                "endpoints": [

                    {

                        "numberOfHops": 30,

                        "mss": 1440,

                        "pathMtu": 1500,

                        "ipAddress": "52.114.229.2",

                        "responseTime": 35,

                        "pathId": "12345678"

                    }

                ],

                "permalink": "https://app.thousandeyes.com/net/path-vis?__a=2067002&testId=5676734&roundId=1745511600&serverId=943404&agentId=1355377"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-24T16:16:52Z",

    "endDate": "2025-04-24T17:16:52Z",

    "test": {

        ...

    },

    "results": [

        {

            "agent": {

                "agentId": "1355377",

                "agentName": "do-lon1-01",

                "countryId": "GB",

                "location": "England, United Kingdom"

            },

            "server": "worldaz.tr.teams.microsoft.com:443",

            "serverIp": "52.114.229.2",

            "sourceIp": "134.209.26.24",

            "sourcePrefix": "134.209.16.0/20",

            "targetIsProxy": false,

            "date": "2025-04-24T16:20:14Z",

            "roundId": 1745511600,

            "startTime": 1745511611,

            "endTime": 1745511614,

            "pathTraces": [

                {

                    "ipAddress": "52.114.229.2",

                    "mss": 1440,

                    "numberOfHops": 30,

                    "pathId": "12345678",

                    "pathMtu": 1500,

                    "responseTime": 35

                }

            ],

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/net/path-vis?__a=2067002&testId=5676734&roundId=1745511600&serverId=943404&agentId=1355377"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5676734/path-vis?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The values for the `direction` query parameter have changed from "FROM_TARGET", "TO_TARGET", and "BIDIRECTIONAL" to "from-target" and "to-target". Omitting the parameter will default to the results from both "from-target" and "to-target" (bidirectional). As in v6, this parameter only applies to Agent-to-Agent tests.

4.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

5.  Test configuration details have moved from within the `net` property to a top-level `test` property. For detailed changes within the `test` property, see the "End-to-End Metrics" section above or refer to the "Tests" migration guide section.

6.  The ` pathVis` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, `location`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

7.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

 

 

Voice

RTP Stream

v6

v7

GET /v6/voice/rtp-stream/{testId}

GET /v7/test-results/{testId}/rtp-server

Response Body

{

    "from": "2025-04-30 13:42:17",

    "to": "2025-04-30 14:42:17",

    "voice": {

        "test": {

            "createdDate": "2025-01-20 18:52:33",

            "modifiedDate": "2025-04-30 14:44:01",

            "createdBy": "Demo User (demo@thousandeyes.com)",

            "modifiedBy": "Demo User (demo@thousandeyes.com)",

            "testId": 6402905,

            "testName": "Webex-Voice-APJC-Singapore",

            "type": "voice",

            "interval": 300,

            "alertsEnabled": 1,

            "bgpMeasurements": 1,

            "codec": "G.711 @ 64 Kbps",

            "codecId": 0,

            "dscp": "EF (DSCP 46)",

            "dscpId": 46,

            "duration": 5,

            "enabled": 1,

            "jitterBuffer": 40,

            "liveShare": 0,

            "numPathTraces": 3,

            "randomizedStartTime": 0,

            "savedEvent": 0,

            "server": "vps1-sin01.webex.ag1.thousandeyes.com:5004",

            "targetAgentId": 364036,

            "usePublicBgp": 1,

            "subinterval": -1,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/6402905"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/voice/rtp-stream/6402905"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/6402905"

                }

            ]

        },

        "metrics": [

            {

                "agentId": 1355391,

                "agentName": "do-blr1-01",

                "countryId": "IN",

                "date": "2025-04-30 13:40:05",

                "roundId": 1746020400,

                "startTime": 1746020400,

                "endTime": 1746020405,

                "serverIp": "170.72.83.11",

                "dscp": 46,

                "dscpName": "EF (DSCP 46)",

                "mos": 4.3964157,

                "codecName": "G.711 @ 64 Kbps",

                "codecMaxMos": 4.41,

                "loss": 0.0,

                "discards": 0.0,

                "latency": 19,

                "pdv": 4,

                "permalink": "https://app.thousandeyes.com/voice/metrics?__a=2067002&testId=6402905&roundId=1746020400&serverId=2095901&agentId=1355391"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-30T13:42:46Z",

    "endDate": "2025-04-30T14:42:46Z",

    "test": {

        "createdDate": "2025-01-20T18:52:33Z",

        "modifiedDate": "2025-04-30T14:44:01Z",

        "createdBy": "Demo User (demo@thousandeyes.com)",

        "modifiedBy": "Demo User (demo@thousandeyes.com)",

        "testId": "6402905",

        "testName": "Webex-Voice-APJC-Singapore",

        "type": "voice",

        "interval": 300,

        "alertsEnabled": true,

        "bgpMeasurements": true,

        "codec": "G.711 @ 64 Kbps",

        "codecId": "0",

        "dscp": "EF (DSCP 46)",

        "dscpId": "46",

        "duration": 5,

        "enabled": true,

        "jitterBuffer": 40,

        "liveShare": false,

        "numPathTraces": 3,

        "randomizedStartTime": false,

        "savedEvent": false,

        "targetAgentId": "364036",

        "usePublicBgp": true,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/voice/6402905"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6402905/rtp-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/6402905/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "1355391",

                "agentName": "do-blr1-01",

                "countryId": "IN"

            },

            "date": "2025-04-30T13:40:05Z",

            "roundId": 1746020400,

            "startTime": 1746020400,

            "endTime": 1746020405,

            "serverIp": "170.72.83.11",

            "dscp": "46",

            "dscpName": "EF (DSCP 46)",

            "mos": 4.3964157,

            "codecName": "G.711 @ 64 Kbps",

            "codecMaxMos": 4.41,

            "loss": 0.0,

            "discards": 0.0,

            "latency": 19,

            "pdv": 4,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/voice/metrics?__a=2067002&testId=6402905&roundId=1746020400&serverId=2095901&agentId=1355391"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/6402905/rtp-server?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `voice` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId`, `targetAgentId`, `dscpId` and `codecId` properties have changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, `liveShare`, `savedEvent`, `enabled`, `randomizedStartTime `, `bgpMeasurements`, and ` usePublicBgp` properties have changed from integer to boolean.

·       The `subinterval` field has been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

5.  The ` metrics` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, `location`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The value of the `dscp` property has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

 

SIP Server

v6

v7

GET /v6/voice/sip-server/{testId}

GET /v7/test-results/{testId}/sip-server

Response Body

{

    "from": "2025-04-30 13:56:10",

    "to": "2025-04-30 14:56:10",

    "voice": {

        "test": {

            "createdDate": "2024-07-18 19:56:43",

            "modifiedDate": "2024-09-11 17:41:23",

            "createdBy": "Demo User (demo@thousandeyes.com)",

            "modifiedBy": "Demo User (demo@thousandeyes.com)",

            "testId": 5622517,

            "testName": "SIP Server Ping",

            "type": "sip-server",

            "interval": 300,

            "alertsEnabled": 1,

            "bgpMeasurements": 1,

            "enabled": 1,

            "ipv6Policy": "USE_AGENT_POLICY",

            "liveShare": 0,

            "mtuMeasurements": 1,

            "networkMeasurements": 1,

            "numPathTraces": 3,

            "optionsRegex": "",

            "pathTraceMode": "inSession",

            "port": 5060,

            "probeMode": "SYN",

            "protocol": "TCP",

            "randomizedStartTime": 0,

            "registerEnabled": 0,

            "savedEvent": 0,

            "server": "px1.nexvortex.com:5060",

            "sipRegistrar": "px1.nexvortex.com",

            "sipTargetTime": 1000,

            "sipTimeLimit": 5,

            "usePublicBgp": 1,

            "bandwidthMeasurements": 0,

            "continuousMode": 0,

            "sipProxy": "",

            "subinterval": -1,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5622517"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/5622517"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/5622517"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/5622517"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/voice/sip-server/5622517"

                }

            ]

        },

        "sipMetrics": [

            {

                "agentId": 1355380,

                "agentName": "do-tor1-01",

                "countryId": "CA",

                "date": "2025-04-30 13:58:19",

                "roundId": 1746021300,

                "startTime": 1746021498,

                "endTime": 1746021499,

                "availability": 100.0,

                "connectTime": 27,

                "dnsTime": 2,

                "errorType": "None",

                "numRedirects": 0,

                "optionsRequest": "...",

                "optionsResponse": "...",

                "optionsTime": 27,

                "responseCode": 200,

                "responseTime": 56,

                "serverIp": "104.219.163.73",

                "totalTime": 57,

                "waitTime": 27,

                "permalink": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5622517&roundId=1746021300&serverId=367736&agentId=1355380"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-30T13:56:07Z",

    "endDate": "2025-04-30T14:56:07Z",

    "test": {

        "createdDate": "2024-07-18T19:56:43Z",

        "modifiedDate": "2024-09-11T17:41:23Z",

        "createdBy": "Demo User (demo@thousandeyes.com)",

        "modifiedBy": "Demo User (demo@thousandeyes.com)",

        "testId": "5622517",

        "testName": "SIP Server Ping",

        "type": "sip-server",

        "interval": 300,

        "alertsEnabled": true,

        "bgpMeasurements": true,

        "enabled": true,

        "ipv6Policy": "use-agent-policy",

        "liveShare": false,

        "mtuMeasurements": true,

        "networkMeasurements": true,

        "numPathTraces": 3,

        "optionsRegex": "",

        "pathTraceMode": "in-session",

        "port": 5060,

        "probeMode": "syn",

        "protocol": "tcp",

        "randomizedStartTime": false,

        "registerEnabled": false,

        "savedEvent": false,

        "sipRegistrar": "px1.nexvortex.com",

        "sipTargetTime": 1000,

        "sipTimeLimit": 5,

        "usePublicBgp": true,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/sip-server/5622517"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5622517/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5622517/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5622517/bgp"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5622517/sip-server"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "1355380",

                "agentName": "do-tor1-01",

                "countryId": "CA"

            },

            "date": "2025-04-30T13:58:19Z",

            "roundId": 1746021300,

            "startTime": 1746021498,

            "endTime": 1746021499,

            "availability": 100.0,

            "connectTime": 27,

            "dnsTime": 2,

            "errorType": "none",

            "numRedirects": 0,

            "optionsRequest": "...",

            "optionsResponse": "...",

            "optionsTime": 27,

            "responseCode": 200,

            "responseTime": 56,

            "serverIp": "104.219.163.73",

            "totalTime": 57,

            "waitTime": 27,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5622517&roundId=1746021300&serverId=367736&agentId=1355380"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5622517/sip-server?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `voice` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId` property has changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, `liveShare`, `savedEvent`, `enabled`, `randomizedStartTime `, `bgpMeasurements`, ` usePublicBgp` and ` registerEnabled` properties have changed from integer to boolean.

·       The values of the `protocol`, `pathTraceMode`, `ipv6Policy`, and `probeMode` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was "USE_AGENT_POLICY", in v7 it is "use-agent-policy"

·       In v6, `pathTraceMode` was "inSession", in v7 it is "in-session"

·       The `subinterval`, ` bandwidthMeasurements`, `continuousMode`, and `sipProxy` field has been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

5.  The `sipMmetrics` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, `location`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

Web

FTP Server

v6

v7

GET /v6/web/ftp-server/{testId}

 

GET /v7/test-results/{testId}/ftp-server

Response Body

{

    "from": "2025-04-24 16:58:51",

    "to": "2025-04-24 17:58:51",

    "web": {

        "test": {

            "createdDate": "2024-07-18 19:48:18",

            "modifiedDate": "2024-09-11 17:41:37",

            "createdBy": "Demo User (demo@thousandeyes.com)",

            "modifiedBy": "Demo User (demo@thousandeyes.com)",

            "testId": 5622489,

            "testName": "SFTP List Files",

            "type": "ftp-server",

            "interval": 300,

            "alertsEnabled": 1,

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 1,

            "enabled": 1,

            "ftpTargetTime": 1000,

            "ftpTimeLimit": 10,

            "ipv6Policy": "USE_AGENT_POLICY",

            "liveShare": 0,

            "mtuMeasurements": 1,

            "networkMeasurements": 1,

            "numPathTraces": 3,

            "pathTraceMode": "classic",

            "probeMode": "AUTO",

            "protocol": "TCP",

            "randomizedStartTime": 0,

            "requestType": "List",

            "savedEvent": 0,

            "url": "sftp://10.1.0.1/home/demo/files/",

            "useActiveFtp": 0,

            "useExplicitFtps": 0,

            "usePublicBgp": 1,

            "username": "demouser",

            "continuousMode": 0,

            "subinterval": -1,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5622489"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/ftp-server/5622489"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/5622489"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/5622489"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/5622489"

                }

            ]

        },

        "ftpServer": [

            {

                "agentId": 1355377,

                "agentName": "do-lon1-01",

                "countryId": "GB",

                "date": "2025-04-24 16:55:05",

                "connectTime": 81.812,

                "dnsTime": 0.038,

                "endTime": 1745513705,

                "errorType": "None",

                "negotiationTime": 2874.138,

                "responseCode": 0,

                "responseTime": 2955.983,

                "roundId": 1745513700,

                "serverIp": "104.131.69.80",

                "startTime": 1745513700,

                "totalTime": 2955.983,

                "wireSize": 196,

                "permalink": "https://app.thousandeyes.com/web/ftp-server?__a=2067002&testId=5622489&roundId=1745513700&serverId=3939047&agentId=1355377"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-24T16:58:06Z",

    "endDate": "2025-04-24T17:58:06Z",

    "test": {

        "createdDate": "2024-07-18T19:48:18Z",

        "modifiedDate": "2024-09-11T17:41:37Z",

        "createdBy": "Demo User (demo@thousandeyes.com)",

        "modifiedBy": "Demo User (demo@thousandeyes.com)",

        "testId": "5622489",

        "testName": "SFTP List Files",

        "type": "ftp-server",

        "interval": 300,

        "alertsEnabled": true,

        "bandwidthMeasurements": false,

        "bgpMeasurements": true,

        "enabled": true,

        "ftpTargetTime": 1000,

        "ftpTimeLimit": 10,

        "ipv6Policy": "use-agent-policy",

        "liveShare": false,

        "mtuMeasurements": true,

        "networkMeasurements": true,

        "numPathTraces": 3,

        "pathTraceMode": "classic",

        "probeMode": "auto",

        "protocol": "tcp",

        "randomizedStartTime": false,

        "requestType": "list",

        "savedEvent": false,

        "url": " sftp://10.1.0.1/home/demo/files/",

        "useActiveFtp": false,

        "useExplicitFtps": false,

        "usePublicBgp": true,

        "username": "demouser",

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/ftp-server/5622489"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5622489/ftp-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5622489/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5622489/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5622489/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "1355377",

                "agentName": "do-lon1-01",

                "countryId": "GB"

            },

            "date": "2025-04-24T16:55:05Z",

            "connectTime": 81.812,

            "dnsTime": 0.038,

            "endTime": 1745513705,

            "errorType": "None",

            "negotiationTime": 2874.138,

            "responseCode": 0,

            "responseTime": 2955.983,

            "roundId": 1745513700,

            "serverIp": "104.131.69.80",

            "startTime": 1745513700,

            "totalTime": 2955.983,

            "wireSize": 196,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/web/ftp-server?__a=2067002&testId=5622489&roundId=1745513700&serverId=3939047&agentId=1355377"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5622489/ftp-server?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `web` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId` property has changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, `liveShare`, `savedEvent`, `enabled`, `randomizedStartTime `, ` networkMeasurements `, ` mtuMeasurements`, ` bandwidthMeasurements`, ` bgpMeasurements`, ` usePublicBgp`,  ` useActiveFtp` and ` useExplicitFtps` properties have changed from integer to boolean.

·       The values of the `protocol`, `ipv6Policy`, `probeMode`, and `requestType` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was "USE_AGENT_POLICY", in v7 it is "use-agent-policy"

·       The `subinterval` and `continuousMode` fields have been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

5.  The `ftpServer` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

HTTP Server

v6

v7

GET /v6/web/http-server/{testId}

GET /v7/test-results/{testId}/http-server

Response Body

{

    "from": "2025-04-24 17:27:21",

    "to": "2025-04-24 18:27:21",

    "web": {

        "test": {

            "createdDate": "2024-08-30 19:26:55",

            "modifiedDate": "2025-02-12 08:40:14",

            "createdBy": "Demo User (demo@thousandeyes.com)",

            "modifiedBy": "Demo User (demo@thousandeyes.com)",

            "testId": 5801517,

            "testName": "AWS Console",

            "type": "http-server",

            "interval": 300,

            "alertsEnabled": 1,

            "allowUnsafeLegacyRenegotiation": 1,

            "authType": "NONE",

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 0,

            "contentRegex": "",

            "enabled": 1,

            "flagCollectProxyNetworkData": 0,

            "flagOverrideAgentProxy": 0,

            "followRedirects": 1,

            "httpTargetTime": 1000,

            "httpTimeLimit": 5,

            "httpVersion": 2,

            "ipv6Policy": "USE_AGENT_POLICY",

            "liveShare": 0,

            "mtuMeasurements": 0,

            "networkMeasurements": 1,

            "numPathTraces": 3,

            "pathTraceMode": "classic",

            "probeMode": "AUTO",

            "protocol": "TCP",

            "randomizedStartTime": 0,

            "savedEvent": 0,

            "sslVersion": "Auto",

            "sslVersionId": 0,

            "url": "https://aws.amazon.com/console/",

            "useNtlm": 0,

            "usePublicBgp": 1,

            "verifyCertificate": 1,

            "continuousMode": 0,

            "subinterval": -1,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5801517"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/http-server/5801517"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/5801517"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/5801517"

                }

            ]

        },

        "httpServer": [

            {

                "agentId": 1156451,

                "agentName": "New Orleans, LA",

                "countryId": "US",

                "date": "2025-04-24 17:25:10",

                "connectTime": 13,

                "dnsTime": 951,

                "endTime": 1745515510,

                "errorType": "None",

                "healthScore": 0.8431755,

                "numRedirects": 0,

                "receiveTime": 52,

                "responseCode": 200,

                "responseHeaders": "...",

                "responseTime": 1160,

                "roundId": 1745515500,

                "serverIp": "13.225.222.12",

                "sslCerts": [

                    {

                        "notValidAfter": "2025-10-06 23:59:59",

                        "notValidBefore": "2024-11-02 00:00:00",

                        "subjectName": "aws.amazon.com",

                        "issuerName": "Amazon RSA 2048 M01",

                        "subjectAltNames": [

                            "aws.amazon.com"

                        ],

                        "fetchDateInValidCertDateRange": true,

                        "daysUntilExpiry": 165

                    },

                ],

                "sslCipher": "TLS_AES_128_GCM_SHA256",

                "sslTime": 55,

                "sslVersion": "TLSv1.3",

                "startTime": 1745515504,

                "throughput": 1655771,

                "totalTime": 1212,

                "waitTime": 141,

                "wireSize": 86471,

                "permalink": "https://app.thousandeyes.com/web/http-server?__a=2067002&testId=5801517&roundId=1745515500&serverId=80709&agentId=1156451"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-24T17:27:14Z",

    "endDate": "2025-04-24T18:27:14Z",

    "test": {

        "createdDate": "2024-08-30T19:26:55Z",

        "modifiedDate": "2025-02-12T08:40:14Z",

        "createdBy": "Demo User (demo@thousandeyes.com)",

        "modifiedBy": "Demo User (demo@thousandeyes.com)",

        "testId": "5801517",

        "testName": "AWS Console",

        "type": "http-server",

        "interval": 300,

        "alertsEnabled": true,

        "allowUnsafeLegacyRenegotiation": true,

        "authType": "none",

        "bandwidthMeasurements": false,

        "bgpMeasurements": false,

        "collectProxyNetworkData": false,

        "contentRegex": "",

        "distributedTracing": false,

        "enabled": true,

        "followRedirects": true,

        "httpTargetTime": 1000,

        "httpTimeLimit": 5,

        "httpVersion": 2,

        "ipv6Policy": "use-agent-policy",

        "liveShare": false,

        "mtuMeasurements": false,

        "networkMeasurements": true,

        "numPathTraces": 3,

        "overrideAgentProxy": false,

        "pathTraceMode": "classic",

        "probeMode": "auto",

        "protocol": "tcp",

        "randomizedStartTime": false,

        "savedEvent": false,

        "sslVersion": "Auto",

        "sslVersionId": "0",

        "url": "https://aws.amazon.com/console/",

        "useNtlm": false,

        "usePublicBgp": true,

        "verifyCertificate": true,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/http-server/5801517"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5801517/http-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5801517/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5801517/path-vis"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "1156451",

                "agentName": "New Orleans, LA",

                "countryId": "US"

            },

            "date": "2025-04-24T17:25:10Z",

            "connectTime": 13,

            "dnsTime": 951,

            "endTime": 1745515510,

            "errorType": "None",

            "headers": {

                "requestHeaders": "...",

                "responseHeaders": "..."

            },

            "healthScore": 0.8431755,

            "numRedirects": 0,

            "receiveTime": 52,

            "responseCode": 200,

            "responseTime": 1160,

            "roundId": 1745515500,

            "serverIp": "13.225.222.12",

            "sslCertificates": [

                {

                    "daysUntilExpiry": 165,

                    "isFetchDateInValidCertDateRange": true,

                    "issuerName": "Amazon RSA 2048 M01",

                    "validBefore": "2025-10-06T23:59:59Z",

                    "validAfter": "2024-11-02T00:00:00Z",

                    "subjectAlternativeNames": [

                        "aws.amazon.com"

                    ],

                    "subjectName": "aws.amazon.com"

                },

            ],

            "sslCipher": "TLS_AES_128_GCM_SHA256",

            "sslTime": 55,

            "sslVersion": "TLSv1.3",

            "startTime": 1745515504,

            "throughput": 1655771,

            "totalTime": 1212,

            "waitTime": 141,

            "wireSize": 86471,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/web/http-server?__a=2067002&testId=5801517&roundId=1745515500&serverId=80709&agentId=1156451"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5801517/http-server?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `headers` query parameter, used to include response header information in the response, has changed to use the `expand=header` query parameter.

4.  The `certificates` query parameter, used to include the certificate chain information in the response, has changed t ouse the `expand=certificate` query parameter. 

5.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

6.  Test configuration details have moved from within the `web` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId` and `sslVersionId` properties has changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, `allowUnsafeLegacyRenegotiation`, `bandwidthMeasurements`, `bgpMeasurements`, `enabled`, `followRedirects`, `liveShare`, `mtuMeasurements`, `networkMeasurements`, `randomizedStartTime `, `savedEvent`, `useNtlm`, ` usePublicBgp`, and `verifyCertificate` properties have changed from integer to boolean.

·       The `flagCollectProxyNetworkData` property has been renamed `collectProxyNetworkData` and its value has changed from integer to string.

·       The `flagOverrideAgentProxy` property has been renamed `overrideAgentProxy` and its value has changed from integer to string.

·       The values of the `protocol`, `ipv6Policy`, `probeMode`, and `authType` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was "USE_AGENT_POLICY", in v7 it is "use-agent-policy"

·       The `subinterval` and `continuousMode` fields have been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

7.  The `httpServer` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

·       The `sslCerts` property has been renamed `sslCertificates`. Within this property:

·       The `notValidAfter` and `notValidBefore` properties have been renamed `validBefore` and `validAfter`, respectively. The values of these properties is now in ISO 8601 format with timezone, e.g, "YYYY-MM-DDTHH:MM:SSZ"

·       The `subjectAltNames` property has been renamed to `subjectAlternativeNames`

·       The `responseHeaders` property has been nested in a new `headers` property, which also includes `requestHeaders`.

8.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

Page Load

v6

v7

GET /v6/web/page-load/{testId}

GET /v7/test-results/{testId}/page-load

Response Body

{

    "from": "2025-04-29 14:35:53",

    "to": "2025-04-29 15:35:53",

    "web": {

        "test": {

            "createdDate": "2024-09-05 13:23:39",

            "modifiedDate": "2024-09-11 17:42:58",

            "createdBy": "Demo User (demo@thousandeyes.com)",

            "modifiedBy": "Demo User (demo@thousandeyes.com)",

            "testId": 5828052,

            "testName": "Pseudoco - Bugzilla",

            "type": "page-load",

            "interval": 600,

            "httpInterval": 600,

            "alertsEnabled": 1,

            "allowGeolocation": 0,

            "allowMicAndCamera": 0,

            "allowUnsafeLegacyRenegotiation": 1,

            "authType": "NONE",

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 1,

            "blockDomains": "",

            "browserLanguage": "en-US",

            "contentRegex": "",

            "description": "",

            "disableScreenshot": 0,

            "emulatedDeviceId": 3,

            "enabled": 1,

            "flagOverrideAgentProxy": 0,

            "followRedirects": 1,

            "httpTargetTime": 1000,

            "httpTimeLimit": 10,

            "httpVersion": 2,

            "includeHeaders": 1,

            "liveShare": 0,

            "mtuMeasurements": 1,

            "networkMeasurements": 1,

            "numPathTraces": 3,

            "pageLoadingStrategy": "normal",

            "pageLoadTargetTime": 6,

            "pageLoadTimeLimit": 10,

            "pathTraceMode": "classic",

            "probeMode": "AUTO",

            "protocol": "TCP",

            "randomizedStartTime": 0,

            "savedEvent": 0,

            "sslVersion": "Auto",

            "sslVersionId": 0,

            "url": "https://bugzilla.pseudoco.net/",

            "useNtlm": 0,

            "usePublicBgp": 1,

            "verifyCertificate": 1,

            "continuousMode": 0,

            "identifyAgentTrafficWithUserAgent": 0,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/http-server/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/page-load/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/5828052"

                }

            ]

        },

        "pageLoad": [

            {

                "agentId": 100,

                "agentName": "Vancouver, Canada",

                "countryId": "CA",

                "date": "2025-04-29 14:33:54",

                "roundId": 1745937000,

                "startTime": 1745937230,

                "endTime": 1745937234,

                "responseTime": 1116.227,

                "totalSize": 41661,

                "numObjects": 9,

                "numErrors": 0,

                "domLoadTime": 1322,

                "pageLoadTime": 1433,

                "permalink": "https://app.thousandeyes.com/web/page-load?__a=2067002&testId=5828052&roundId=1745937000&serverId=3967988&agentId=100"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-29T14:35:07Z",

    "endDate": "2025-04-29T15:35:07Z",

    "test": {

        "createdDate": "2024-09-05T13:23:39Z",

        "modifiedDate": "2024-09-11T17:42:58Z",

        "createdBy": "Demo User (demo@thousandeyes.com)",

        "modifiedBy": "Demo User (demo@thousandeyes.com)",

        "testId": "5828052",

        "testName": "Pseudoco - Bugzilla",

        "type": "page-load",

        "interval": 600,

        "httpInterval": 600,

        "alertsEnabled": true,

        "allowGeolocation": false,

        "allowMicAndCamera": false,

        "allowUnsafeLegacyRenegotiation": true,

        "authType": "none",

        "bandwidthMeasurements": false,

        "bgpMeasurements": true,

        "blockDomains": "",

        "browserLanguage": "en-US",

        "contentRegex": "",

        "description": "",

        "disableScreenshot": false,

        "emulatedDeviceId": "3",

        "enabled": true,

        "overrideAgentProxy": false,

        "followRedirects": true,

        "httpTargetTime": 1000,

        "httpTimeLimit": 10,

        "httpVersion": 2,

        "includeHeaders": true,

        "liveShare": false,

        "mtuMeasurements": true,

        "networkMeasurements": true,

        "numPathTraces": 3,

        "pageLoadingStrategy": "normal",

        "pageLoadTargetTime": 6,

        "pageLoadTimeLimit": 10,

        "pathTraceMode": "classic",

        "probeMode": "auto",

        "protocol": "tcp",

        "randomizedStartTime": false,

        "savedEvent": false,

        "sslVersion": "Auto",

        "sslVersionId": "0",

        "url": "https://bugzilla.pseudoco.net/",

        "useNtlm": false,

        "usePublicBgp": true,

        "verifyCertificate": true,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/page-load/5828052"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/http-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/page-load"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "100",

                "agentName": "Vancouver, Canada",

                "countryId": "CA"

            },

            "date": "2025-04-29T14:33:54Z",

            "roundId": 1745937000,

            "startTime": 1745937230,

            "endTime": 1745937234,

            "responseTime": 1116.227,

            "totalSize": 41661,

            "numObjects": 9,

            "numErrors": 0,

            "domLoadTime": 1322,

            "pageLoadTime": 1433,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/web/page-load?__a=2067002&testId=5828052&roundId=1745937000&serverId=3967988&agentId=100"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5828052/page-load?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `web` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId`, ` emulatedDeviceId`, and `sslVersionId` properties have changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, ` allowGeolocation`, `allowMicAndCamera`, `allowUnsafeLegacyRenegotiation`, `bandwidthMeasurements`, `bgpMeasurements`, ` disableScreenshot`, `enabled`, `followRedirects`, ` includeHeaders`, `liveShare`, `mtuMeasurements`, `networkMeasurements`, `randomizedStartTime `, `savedEvent`, `useNtlm`, ` usePublicBgp`, and `verifyCertificate` properties have changed from integer to boolean.

·       The `flagOverrideAgentProxy` property has been renamed `overrideAgentProxy` and its value has changed from integer to string.

·       The values of the `protocol`, `probeMode`, and `authType` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was "USE_AGENT_POLICY", in v7 it is "use-agent-policy"

·       The ` identifyAgentTrafficWithUserAgent` and `continuousMode` fields have been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

5.  The `pageLoad` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

 

Page Load Component Detail

v6

v7

GET /v6/web/page-load/{testId}/{agentId}/{roundId}

 

GET /v7/test-results/{testId}/page-load/agent/{agentId}/round/{roundId}

Response Body

{

    "web": {

        "test": {

            "createdDate": "2024-09-05 13:23:39",

            "modifiedDate": "2024-09-11 17:42:58",

            "createdBy": "Demo User (demo@thousandeyes.com)",

            "modifiedBy": "Demo User (demo@thousandeyes.com)",

            "testId": 5828052,

            "testName": "Pseudoco - Bugzilla",

            "type": "page-load",

            "interval": 600,

            "httpInterval": 600,

            "alertsEnabled": 1,

            "allowGeolocation": 0,

            "allowMicAndCamera": 0,

            "allowUnsafeLegacyRenegotiation": 1,

            "authType": "NONE",

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 1,

            "blockDomains": "",

            "browserLanguage": "en-US",

            "contentRegex": "",

            "description": "",

            "disableScreenshot": 0,

            "emulatedDeviceId": 3,

            "enabled": 1,

            "flagOverrideAgentProxy": 0,

            "followRedirects": 1,

            "httpTargetTime": 1000,

            "httpTimeLimit": 10,

            "httpVersion": 2,

            "includeHeaders": 1,

            "liveShare": 0,

            "mtuMeasurements": 1,

            "networkMeasurements": 1,

            "numPathTraces": 3,

            "pageLoadingStrategy": "normal",

            "pageLoadTargetTime": 6,

            "pageLoadTimeLimit": 10,

            "pathTraceMode": "classic",

            "probeMode": "AUTO",

            "protocol": "TCP",

            "randomizedStartTime": 0,

            "savedEvent": 0,

            "sslVersion": "Auto",

            "sslVersionId": 0,

            "url": "https://bugzilla.pseudoco.net/",

            "useNtlm": 0,

            "usePublicBgp": 1,

            "verifyCertificate": 1,

            "continuousMode": 0,

            "identifyAgentTrafficWithUserAgent": 0,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/http-server/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/page-load/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/5828052"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/5828052"

                }

            ]

        },

        "pageLoad": [

            {

                "agentId": 100,

                "agentName": "Vancouver, Canada",

                "countryId": "CA",

                "date": "2025-04-29 14:33:54",

                "roundId": 1745937000,

                "startTime": 1745937230,

                "endTime": 1745937234,

                "responseTime": 1116.227,

                "totalSize": 41661,

                "numObjects": 9,

                "numErrors": 0,

                "domLoadTime": 1322,

                "pageLoadTime": 1433,

                "har": {

                    "log": {

                        "creator": {

                            "name": "ThousandEyes DB Exporter"

                        },

                        "entries": [

                            {

                                "pageref": "page_0",

                                "serverIPAddress": "18.118.119.55",

                                "startedDateTime": "2025-04-29T14:33:51.237Z",

                                "time": 1118,

                                "timings": {

                                    "blocked": 75,

                                    "dns": 0,

                                    "connect": 113,

                                    "ssl": 61,

                                    "send": 0,

                                    "wait": 928,

                                    "receive": 2

                                },

                                "request": {

                                    "url": "https://bugzilla.pseudoco.net/",

                                    "headers": [

                                        {

                                            "name": "X-ThousandEyes-Agent",

                                            "value": "yes"

                                        }

                                    ],

                                    "method": "GET"

                                },

                                "response": {

                                    "headersSize": 420,

                                    "bodySize": 2741,

                                    "status": 200,

                                    "headers": [

                                        {

                                            "name": "Connection",

                                            "value": "Keep-Alive"

                                        }

                                    ],

                                    "content": {

                                        "size": 11516,

                                        "mimeType": "text/html"

                                    },

                                    "_statusText": "OK",

                                    "_cached": false,

                                    "redirectURL": "",

                                    "statusText": "OK"

                                }

                            }

                        ],

                        "pages": [

                            {

                                "id": "page_0",

                                "title": "Bugzilla Main Page",

                                "startedDateTime": "2025-04-29T14:33:51.243Z",

                                "responseCode": 0,

                                "pageTimings": {

                                    "onLoad": 1433,

                                    "onContentLoad": 1322

                                }

                            }

                        ],

                        "version": "1.2"

                    }

                },

                "permalink": "https://app.thousandeyes.com/web/page-load?__a=null&testId=5828052&roundId=1745937000&serverId=3967988&agentId=100"

            }

        ]

    }

}

{

    "test": {

        "createdDate": "2024-09-05T13:23:39Z",

        "modifiedDate": "2024-09-11T17:42:58Z",

        "createdBy": "Demo User (demo@thousandeyes.com)",

        "modifiedBy": "Demo User (demo@thousandeyes.com)",

        "testId": "5828052",

        "testName": "Pseudoco - Bugzilla",

        "type": "page-load",

        "interval": 600,

        "httpInterval": 600,

        "alertsEnabled": true,

        "allowGeolocation": false,

        "allowMicAndCamera": false,

        "allowUnsafeLegacyRenegotiation": true,

        "authType": "none",

        "bandwidthMeasurements": false,

        "bgpMeasurements": true,

        "blockDomains": "",

        "browserLanguage": "en-US",

        "contentRegex": "",

        "description": "",

        "disableScreenshot": false,

        "emulatedDeviceId": "3",

        "enabled": true,

        "overrideAgentProxy": false,

        "followRedirects": true,

        "httpTargetTime": 1000,

        "httpTimeLimit": 10,

        "httpVersion": 2,

        "includeHeaders": true,

        "liveShare": false,

        "mtuMeasurements": true,

        "networkMeasurements": true,

        "numPathTraces": 3,

        "pageLoadingStrategy": "normal",

        "pageLoadTargetTime": 6,

        "pageLoadTimeLimit": 10,

        "pathTraceMode": "classic",

        "probeMode": "auto",

        "protocol": "tcp",

        "randomizedStartTime": false,

        "savedEvent": false,

        "sslVersion": "Auto",

        "sslVersionId": "0",

        "url": "https://bugzilla.pseudoco.net/",

        "useNtlm": false,

        "usePublicBgp": true,

        "verifyCertificate": true,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/page-load/5828052"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/http-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/page-load"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5828052/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "100",

                "agentName": "Vancouver, Canada",

                "countryId": "CA"

            },

            "date": "2025-04-29T14:33:54Z",

            "roundId": 1745937000,

            "startTime": 1745937230,

            "endTime": 1745937234,

            "responseTime": 1116.227,

            "totalSize": 41661,

            "numObjects": 9,

            "numErrors": 0,

            "domLoadTime": 1322,

            "pageLoadTime": 1433,

            "har": {

                "log": {

                    "creator": {

                        "name": "ThousandEyes DB Exporter"

                    },

                    "entries": [

                        {

                            "pageref": "page_0",

                            "serverIPAddress": "18.118.119.55",

                            "startedDateTime": "2025-04-29T14:33:51.237Z",

                            "time": 1118,

                            "timings": {

                                "blocked": 75,

                                "dns": 0,

                                "connect": 113,

                                "ssl": 61,

                                "send": 0,

                                "wait": 928,

                                "receive": 2

                            },

                            "request": {

                                "url": "https://bugzilla.pseudoco.net/",

                                "headers": [

                                    {

                                        "name": "X-ThousandEyes-Agent",

                                        "value": "yes"

                                    }

                                ],

                                "method": "GET"

                            },

                            "response": {

                                "headersSize": 420,

                                "bodySize": 2741,

                                "status": 200,

                                "headers": [

                                    {

                                        "name": "Connection",

                                        "value": "Keep-Alive"

                                    }

                                ],

                                "content": {

                                    "size": 11516,

                                    "mimeType": "text/html"

                                },

                                "_statusText": "OK",

                                "_cached": false,

                                "redirectURL": "",

                                "statusText": "OK"

                            }

                        }

                    ],

                    "pages": [

                        {

                            "id": "page_0",

                            "title": "Bugzilla Main Page",

                            "startedDateTime": "2025-04-29T14:33:51.243Z",

                            "responseCode": 0,

                            "pageTimings": {

                                "onLoad": 1433,

                                "onContentLoad": 1322

                            }

                        }

                    ],

                    "version": "1.2"

                }

            },

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/web/page-load?__a=null&testId=5828052&roundId=1745937000&serverId=3967988&agentId=100"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5828052/page-load/agent/100/round/1745937000"

        }

    }

}

Comments:

1.  The URL has changed.

2.  Test configuration details have moved from within the `web` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId`, ` emulatedDeviceId`, and `sslVersionId` properties have changed from integer to string.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, ` allowGeolocation`, `allowMicAndCamera`, `allowUnsafeLegacyRenegotiation`, `bandwidthMeasurements`, `bgpMeasurements`, ` disableScreenshot`, `enabled`, `followRedirects`, ` includeHeaders`, `liveShare`, `mtuMeasurements`, `networkMeasurements`, `randomizedStartTime `, `savedEvent`, `useNtlm`, ` usePublicBgp`, and `verifyCertificate` properties have changed from integer to boolean.

·       The `flagOverrideAgentProxy` property has been renamed `overrideAgentProxy` and its value has changed from integer to string.

·       The values of the `protocol`, `probeMode`, and `authType` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was "USE_AGENT_POLICY", in v7 it is "use-agent-policy"

·       The ` identifyAgentTrafficWithUserAgent` and `continuousMode` fields have been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

3.  The `pageLoad` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

 

 

Web Transactions

v6

v7

GET /v6/web/web-transactions/{testId}

GET /v7/test-results/{testId}/web-transactions

Response Body

{

    "from": "2025-04-29 17:36:34",

    "to": "2025-04-29 18:36:34",

    "web": {

        "test": {

            "createdDate": "2024-09-06 15:05:39",

            "modifiedDate": "2025-01-07 14:22:12",

            "createdBy": " Demo User (demo@thousandeyes.com)",

            "modifiedBy": " Demo User (demo@thousandeyes.com)",

            "testId": 5834349,

            "testName": "Pseudoco - Transaction - Navigate Repo",

            "type": "web-transactions",

            "interval": 900,

            "alertsEnabled": 1,

            "allowGeolocation": 0,

            "allowMicAndCamera": 0,

            "allowUnsafeLegacyRenegotiation": 1,

            "authType": "NONE",

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 1,

            "blockDomains": "",

            "browserLanguage": "en-US",

            "contentRegex": "",

            "credentials": [

                160481

            ],

            "disableScreenshot": 0,

            "emulatedDeviceId": 3,

            "enabled": 1,

            "flagOverrideAgentProxy": 0,

            "followRedirects": 1,

            "httpTargetTime": 1000,

            "httpTimeLimit": 5,

            "httpVersion": 2,

            "includeHeaders": 1,

            "liveShare": 0,

            "mtuMeasurements": 1,

            "networkMeasurements": 1,

            "numPathTraces": 3,

            "pageLoadingStrategy": "normal",

            "pathTraceMode": "classic",

            "probeMode": "AUTO",

            "protocol": "TCP",

            "randomizedStartTime": 0,

            "savedEvent": 0,

            "sslVersion": "Auto",

            "sslVersionId": 0,

            "targetTime": 10,

            "timeLimit": 30,

            "transactionScript": "...",

            "url": "https://gitea.pseudoco.net/",

            "useNtlm": 0,

            "usePublicBgp": 1,

            "verifyCertificate": 1,

            "continuousMode": 0,

            "credentials": [],

            "identifyAgentTrafficWithUserAgent": 0,

            "isApi": 0,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/http-server/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/web-transactions/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/5834349"

                }

            ]

        },

        "webTransaction": [

            {

                "agentId": 13537,

                "agentName": "Sacramento, CA",

                "countryId": "US",

                "date": "2025-04-29 17:32:29",

                "roundId": 1745947800,

                "startTime": 1745947936,

                "endTime": 1745947949,

                "componentErrors": 0,

                "transactionTime": 9919,

                "permalink": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5834349&roundId=1745947800&serverId=3968015&agentId=13537"

            }

        ]

    },

    "pages": {

        "current": 1

    }

}

{

    "startDate": "2025-04-29T17:36:36Z",

    "endDate": "2025-04-29T18:36:36Z",

    "test": {

        "createdDate": "2024-09-06T15:05:39Z",

        "modifiedDate": "2025-01-07T14:22:12Z",

        "createdBy": " Demo User (demo@thousandeyes.com)",

        "modifiedBy": " Demo User (demo@thousandeyes.com)",

        "testId": "5834349",

        "testName": "Pseudoco - Transaction - Navigate Repo",

        "type": "web-transactions",

        "interval": 900,

        "alertsEnabled": true,

        "allowGeolocation": false,

        "allowMicAndCamera": false,

        "allowUnsafeLegacyRenegotiation": true,

        "authType": "none",

        "bandwidthMeasurements": false,

        "bgpMeasurements": true,

        "blockDomains": "",

        "browserLanguage": "en-US",

        "contentRegex": "",

        "credentials": [

            "160481"

        ],

        "disableScreenshot": false,

        "emulatedDeviceId": "3",

        "enabled": true,

        "overrideAgentProxy": false,

        "followRedirects": true,

        "httpTargetTime": 1000,

        "httpTimeLimit": 5,

        "httpVersion": 2,

        "includeHeaders": true,

        "liveShare": false,

        "mtuMeasurements": true,

        "networkMeasurements": true,

        "numPathTraces": 3,

        "pageLoadingStrategy": "normal",

        "pathTraceMode": "classic",

        "probeMode": "auto",

        "protocol": "tcp",

        "randomizedStartTime": false,

        "savedEvent": false,

        "sslVersion": "Auto",

        "sslVersionId": "0",

        "targetTime": 10,

        "timeLimit": 30,

        "transactionScript": "...",

        "url": "https://gitea.pseudoco.net/",

        "useNtlm": false,

        "usePublicBgp": true,

        "verifyCertificate": true,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/web-transactions/5834349"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/http-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/web-transactions"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "13537",

                "agentName": "Sacramento, CA",

                "countryId": "US"

            },

            "date": "2025-04-29T17:32:29Z",

            "roundId": 1745947800,

            "startTime": 1745947936,

            "endTime": 1745947949,

            "componentErrors": 0,

            "transactionTime": 9919,

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5834349&roundId=1745947800&serverId=3968015&agentId=13537"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5834349/web-transactions?window=1h"

        }

    }

}

Comments:

1.  The URL has changed.

2.  The `from` and `to` query parameters have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-ddTHH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

3.  The `from` and `to` properties in the response body have been renamed `startDate` and `endDate`. The format of their timestamp values has changed.

·       v6: Date and time in the format "YYYY-mm-dd HH:MM:SS"

·       v7: ISO 8601 format with timezone 2022-07-17T22:00:54Z.

4.  Test configuration details have moved from within the `web` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId`, ` emulatedDeviceId`, and `sslVersionId` properties have changed from integer to string.

·       The values within the `credentials` property array have changed from integer to string. Also, the `crednetials` property is only included in the response if at least one credential is assigned to the test, otherwise this property is omitted in the response.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, ` allowGeolocation`, `allowMicAndCamera`, `allowUnsafeLegacyRenegotiation`, `bandwidthMeasurements`, `bgpMeasurements`, ` disableScreenshot`, `enabled`, `followRedirects`, ` includeHeaders`, `liveShare`, `mtuMeasurements`, `networkMeasurements`, `randomizedStartTime `, `savedEvent`, `useNtlm`, ` usePublicBgp`, and `verifyCertificate` properties have changed from integer to boolean.

·       The `flagOverrideAgentProxy` property has been renamed `overrideAgentProxy` and its value has changed from integer to string.

·       The values of the `protocol`, `probeMode`, and `authType` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was "USE_AGENT_POLICY", in v7 it is "use-agent-policy"

·       The ` identifyAgentTrafficWithUserAgent`, ` isApi`, and `continuousMode` fields have been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

5.  The ` webTransaction ` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

6.  The `pages` property has been replaced with the `_links` property. See the APIv7 pagination guide for more details.

 

Web Transactions Detail

v6

v7

GET /v6/web/web-transactions/{testId}/{agentId}/{roundId}

GET /v7/test-results/{testId}/web-transactions/agent/{agentId}/round/{roundId}

Response Body

{

    "web": {

        "test": {

            "createdDate": "2024-09-06 15:05:39",

            "modifiedDate": "2025-01-07 14:22:12",

            "createdBy": " Demo User (demo@thousandeyes.com)",

            "modifiedBy": " Demo User (demo@thousandeyes.com)",

            "testId": 5834349,

            "testName": "Pseudoco - Transaction - Navigate Repo",

            "type": "web-transactions",

            "interval": 900,

            "alertsEnabled": 1,

            "allowGeolocation": 0,

            "allowMicAndCamera": 0,

            "allowUnsafeLegacyRenegotiation": 1,

            "authType": "NONE",

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 1,

            "blockDomains": "",

            "browserLanguage": "en-US",

            "contentRegex": "",

            "credentials": [

                160481

            ],

            "disableScreenshot": 0,

            "emulatedDeviceId": 3,

            "enabled": 1,

            "flagOverrideAgentProxy": 0,

            "followRedirects": 1,

            "httpTargetTime": 1000,

            "httpTimeLimit": 5,

            "httpVersion": 2,

            "includeHeaders": 1,

            "liveShare": 0,

            "mtuMeasurements": 1,

            "networkMeasurements": 1,

            "numPathTraces": 3,

            "pageLoadingStrategy": "normal",

            "pathTraceMode": "classic",

            "probeMode": "AUTO",

            "protocol": "TCP",

            "randomizedStartTime": 0,

            "savedEvent": 0,

            "sslVersion": "Auto",

            "sslVersionId": 0,

            "targetTime": 10,

            "timeLimit": 30,

            "transactionScript": "...",

            "url": "https://gitea.pseudoco.net/",

            "useNtlm": 0,

            "usePublicBgp": 1,

            "verifyCertificate": 1,

            "continuousMode": 0,

            "credentials": [],

            "identifyAgentTrafficWithUserAgent": 0,

            "isApi": 0,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/http-server/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/web-transactions/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/5834349"

                }

            ]

        },

        "webTransaction": [

            {

                "agentId": 13537,

                "agentName": "Sacramento, CA",

                "countryId": "US",

                "date": "2025-04-29 17:32:29",

                "startTime": 1745947936,

                "endTime": 1745947949,

                "roundId": 1745947800,

                "componentErrors": 0,

                "transactionTime": 9919,

                "markers": [

                    {

                        "name": "Landing Page",

                        "duration": 925.0

                    }

                ],

                "pages": [

                    {

                        "pageNum": 0,

                        "pageName": "Gitea: Git with a cup of tea",

                        "duration": 729.0

                    }

                ],

                "permalink": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5834349&roundId=1745947800&serverId=3968015&agentId=13537"

            }

        ]

    }

}

{

    "test": {

        "createdDate": "2024-09-06T15:05:39Z",

        "modifiedDate": "2025-01-07T14:22:12Z",

        "createdBy": " Demo User (demo@thousandeyes.com)",

        "modifiedBy": " Demo User (demo@thousandeyes.com)",

        "testId": "5834349",

        "testName": "Pseudoco - Transaction - Navigate Repo",

        "type": "web-transactions",

        "interval": 900,

        "alertsEnabled": true,

        "allowGeolocation": false,

        "allowMicAndCamera": false,

        "allowUnsafeLegacyRenegotiation": true,

        "authType": "none",

        "bandwidthMeasurements": false,

        "bgpMeasurements": true,

        "blockDomains": "",

        "browserLanguage": "en-US",

        "contentRegex": "",

        "credentials": [

            "160481"

        ],

        "disableScreenshot": false,

        "emulatedDeviceId": "3",

        "enabled": true,

        "overrideAgentProxy": false,

        "followRedirects": true,

        "httpTargetTime": 1000,

        "httpTimeLimit": 5,

        "httpVersion": 2,

        "includeHeaders": true,

        "liveShare": false,

        "mtuMeasurements": true,

        "networkMeasurements": true,

        "numPathTraces": 3,

        "pageLoadingStrategy": "normal",

        "pathTraceMode": "classic",

        "probeMode": "auto",

        "protocol": "tcp",

        "randomizedStartTime": false,

        "savedEvent": false,

        "sslVersion": "Auto",

        "sslVersionId": "0",

        "targetTime": 10,

        "timeLimit": 30,

        "transactionScript": "...",

        "url": "https://gitea.pseudoco.net/",

        "useNtlm": false,

        "usePublicBgp": true,

        "verifyCertificate": true,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/web-transactions/5834349"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/http-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/web-transactions"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "13537",

                "agentName": "Sacramento, CA",

                "countryId": "US"

            },

            "date": "2025-04-29T17:32:29Z",

            "roundId": 1745947800,

            "startTime": 1745947936,

            "endTime": 1745947949,

            "componentErrors": 0,

            "transactionTime": 9919,

            "markers": [

                {

                    "name": "Landing Page",

                    "duration": 925.0

                }

            ],

            "pages": [

                {

                    "pageNum": 0,

                    "pageName": "Gitea: Git with a cup of tea",

                    "duration": 729.0

                }

            ],

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5834349&roundId=1745947800&serverId=3968015&agentId=13537"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5834349/web-transactions/agent/13537/round/1745947800"

        }

    }

}

Comments:

1.  The URL has changed.

2.  Test configuration details have moved from within the `web` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId`, ` emulatedDeviceId`, and `sslVersionId` properties have changed from integer to string.

·       The values within the `credentials` property array have changed from integer to string. Also, the `crednetials` property is only included in the response if at least one credential is assigned to the test, otherwise this property is omitted in the response.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, ` allowGeolocation`, `allowMicAndCamera`, `allowUnsafeLegacyRenegotiation`, `bandwidthMeasurements`, `bgpMeasurements`, ` disableScreenshot`, `enabled`, `followRedirects`, ` includeHeaders`, `liveShare`, `mtuMeasurements`, `networkMeasurements`, `randomizedStartTime `, `savedEvent`, `useNtlm`, ` usePublicBgp`, and `verifyCertificate` properties have changed from integer to boolean.

·       The `flagOverrideAgentProxy` property has been renamed `overrideAgentProxy` and its value has changed from integer to string.

·       The values of the `protocol`, `probeMode`, and `authType` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was "USE_AGENT_POLICY", in v7 it is "use-agent-policy"

·       The ` identifyAgentTrafficWithUserAgent`, ` isApi`, and `continuousMode` fields have been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

3.  The ` webTransaction ` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

·       The `markers` property is only present if there is at least one marker in the results for this test, round, and agent. Otherwise, the `markers` property is omitted from the response.

 

 

Web Transactions Component Detail

v6

v7

GET /v6/web/web-transactions/{testId}/{agentId}/{roundId}/{pageNum}

GET /v7/test-results/{testId}/web-transactions/agent/{agentId}/round/{roundId}/page/{pageId}

Response Body

{

    "web": {

        "test": {

            "createdDate": "2024-09-06 15:05:39",

            "modifiedDate": "2025-01-07 14:22:12",

            "createdBy": " Demo User (demo@thousandeyes.com)",

            "modifiedBy": " Demo User (demo@thousandeyes.com)",

            "testId": 5834349,

            "testName": "Pseudoco - Transaction - Navigate Repo",

            "type": "web-transactions",

            "interval": 900,

            "alertsEnabled": 1,

            "allowGeolocation": 0,

            "allowMicAndCamera": 0,

            "allowUnsafeLegacyRenegotiation": 1,

            "authType": "NONE",

            "bandwidthMeasurements": 0,

            "bgpMeasurements": 1,

            "blockDomains": "",

            "browserLanguage": "en-US",

            "contentRegex": "",

            "credentials": [

                160481

            ],

            "disableScreenshot": 0,

            "emulatedDeviceId": 3,

            "enabled": 1,

            "flagOverrideAgentProxy": 0,

            "followRedirects": 1,

            "httpTargetTime": 1000,

            "httpTimeLimit": 5,

            "httpVersion": 2,

            "includeHeaders": 1,

            "liveShare": 0,

            "mtuMeasurements": 1,

            "networkMeasurements": 1,

            "numPathTraces": 3,

            "pageLoadingStrategy": "normal",

            "pathTraceMode": "classic",

            "probeMode": "AUTO",

            "protocol": "TCP",

            "randomizedStartTime": 0,

            "savedEvent": 0,

            "sslVersion": "Auto",

            "sslVersionId": 0,

            "targetTime": 10,

            "timeLimit": 30,

            "transactionScript": "...",

            "url": "https://gitea.pseudoco.net/",

            "useNtlm": 0,

            "usePublicBgp": 1,

            "verifyCertificate": 1,

            "continuousMode": 0,

            "credentials": [],

            "identifyAgentTrafficWithUserAgent": 0,

            "isApi": 0,

            "apiLinks": [

                {

                    "rel": "self",

                    "href": "https://api.thousandeyes.com/v6/tests/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/http-server/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/web/web-transactions/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/metrics/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/path-vis/5834349"

                },

                {

                    "rel": "data",

                    "href": "https://api.thousandeyes.com/v6/net/bgp-metrics/5834349"

                }

            ]

        },

        "webTransaction": [

            {

                "agentId": 13537,

                "agentName": "Sacramento, CA",

                "countryId": "US",

                "date": "2025-04-29 17:32:29",

                "startTime": 1745947936,

                "endTime": 1745947949,

                "roundId": 1745947800,

                "componentErrors": 0,

                "transactionTime": 9919,

                "markers": [

                    {

                        "name": "Landing Page",

                        "duration": 925.0

                    }

                ],

                "pages": [

                    {

                        "pageNum": 0,

                        "pageName": "Gitea: Git with a cup of tea",

                        "duration": 729.0

                    }

                ],

                "har": {

                    "log": {

                        "creator": {

                            "name": "ThousandEyes DB Exporter"

                        },

                        "entries": [

                            {

                                "pageref": "page_0",

                                "serverIPAddress": "13.248.129.89",

                                "startedDateTime": "2025-04-29T17:32:18.575Z",

                                "time": 247,

                                "timings": {

                                    "blocked": 15,

                                    "dns": 0,

                                    "connect": 152,

                                    "ssl": 145,

                                    "send": 1,

                                    "wait": 76,

                                    "receive": 3

                                },

                                "request": {

                                    "url": "https://gitea.pseudoco.net/",

                                    "headers": [

                                        {

                                            "name": ":authority",

                                            "value": "gitea.pseudoco.net"

                                        }

                                    ],

                                    "method": "GET"

                                },

                                "response": {

                                    "headersSize": 440,

                                    "bodySize": -1,

                                    "status": 200,

                                    "headers": [

                                        {

                                            "name": "cache-control",

                                            "value": "max-age=0, private, must-revalidate, no-transform"

                                        }

                                    ],

                                    "content": {

                                        "size": 13621,

                                        "mimeType": "text/html"

                                    },

                                    "_statusText": "OK",

                                    "_cached": false,

                                    "redirectURL": "",

                                    "statusText": "OK"

                                }

                            }

                           

                        ],

                        "pages": [

                            {

                                "id": "page_0",

                                "title": "Gitea: Git with a cup of tea",

                                "startedDateTime": "2025-04-29T17:32:18.581Z",

                                "responseCode": 0,

                                "pageTimings": {

                                    "onLoad": 729,

                                    "onContentLoad": 728

                                }

                            }

                        ],

                        "version": "1.2"

                    }

                },

                "permalink": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5834349&roundId=1745947800&serverId=3968015&agentId=13537"

            }

        ]

    }

}

{

    "test": {

        "createdDate": "2024-09-06T15:05:39Z",

        "modifiedDate": "2025-01-07T14:22:12Z",

        "createdBy": " Demo User (demo@thousandeyes.com)",

        "modifiedBy": " Demo User (demo@thousandeyes.com)",

        "testId": "5834349",

        "testName": "Pseudoco - Transaction - Navigate Repo",

        "type": "web-transactions",

        "interval": 900,

        "alertsEnabled": true,

        "allowGeolocation": false,

        "allowMicAndCamera": false,

        "allowUnsafeLegacyRenegotiation": true,

        "authType": "none",

        "bandwidthMeasurements": false,

        "bgpMeasurements": true,

        "blockDomains": "",

        "browserLanguage": "en-US",

        "contentRegex": "",

        "credentials": [

            "160481"

        ],

        "disableScreenshot": false,

        "emulatedDeviceId": "3",

        "enabled": true,

        "overrideAgentProxy": false,

        "followRedirects": true,

        "httpTargetTime": 1000,

        "httpTimeLimit": 5,

        "httpVersion": 2,

        "includeHeaders": true,

        "liveShare": false,

        "mtuMeasurements": true,

        "networkMeasurements": true,

        "numPathTraces": 3,

        "pageLoadingStrategy": "normal",

        "pathTraceMode": "classic",

        "probeMode": "auto",

        "protocol": "tcp",

        "randomizedStartTime": false,

        "savedEvent": false,

        "sslVersion": "Auto",

        "sslVersionId": "0",

        "targetTime": 10,

        "timeLimit": 30,

        "transactionScript": "...",

        "url": "https://gitea.pseudoco.net/",

        "useNtlm": false,

        "usePublicBgp": true,

        "verifyCertificate": true,

        "_links": {

            "self": {

                "href": "https://api.thousandeyes.com/v7/tests/web-transactions/5834349"

            },

            "testResults": [

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/http-server"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/web-transactions"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/network"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/path-vis"

                },

                {

                    "href": "https://api.thousandeyes.com/v7/test-results/5834349/bgp"

                }

            ]

        }

    },

    "results": [

        {

            "agent": {

                "agentId": "13537",

                "agentName": "Sacramento, CA",

                "countryId": "US"

            },

            "date": "2025-04-29T17:32:29Z",

            "roundId": 1745947800,

            "startTime": 1745947936,

            "endTime": 1745947949,

            "componentErrors": 0,

            "transactionTime": 9919,

            "markers": [

                {

                    "name": "Landing Page",

                    "duration": 925.0

                }

            ],

            "pages": [

                {

                    "pageNum": 0,

                    "pageName": "Gitea: Git with a cup of tea",

                    "duration": 729.0

                }

            ],

            "har": {

                "log": {

                    "creator": {

                        "name": "ThousandEyes DB Exporter"

                    },

                    "entries": [

                        {

                            "pageref": "page_0",

                            "serverIPAddress": "13.248.129.89",

                            "startedDateTime": "2025-04-29T17:32:18.575Z",

                            "time": 247,

                            "timings": {

                                "blocked": 15,

                                "dns": 0,

                                "connect": 152,

                                "ssl": 145,

                                "send": 1,

                                "wait": 76,

                                "receive": 3

                            },

                            "request": {

                                "url": "https://gitea.pseudoco.net/",

                                "headers": [

                                    {

                                        "name": ":authority",

                                        "value": "gitea.pseudoco.net"

                                    }

                                ],

                                "method": "GET"

                            },

                            "response": {

                                "headersSize": 440,

                                "bodySize": -1,

                                "status": 200,

                                "headers": [

                                    {

                                        "name": "cache-control",

                                        "value": "max-age=0, private, must-revalidate, no-transform"

                                    }

                                ],

                                "content": {

                                    "size": 13621,

                                    "mimeType": "text/html"

                                },

                                "_statusText": "OK",

                                "_cached": false,

                                "redirectURL": "",

                                "statusText": "OK"

                            }

                        }

                    ],

                    "pages": [

                        {

                            "id": "page_0",

                            "title": "Gitea: Git with a cup of tea",

                            "startedDateTime": "2025-04-29T17:32:18.581Z",

                            "responseCode": 0,

                            "pageTimings": {

                                "onLoad": 729,

                                "onContentLoad": 728

                            }

                        }

                    ],

                    "version": "1.2"

                }

            },

            "_links": {

                "appLink": {

                    "href": "https://app.thousandeyes.com/view/tests?__a=2067002&testId=5834349&roundId=1745947800&serverId=3968015&agentId=13537"

                }

            }

        }

    ],

    "_links": {

        "self": {

            "href": "https://api.thousandeyes.com/v7/test-results/5834349/web-transactions/agent/13537/round/1745947800"

        }

    }

}

Comments:

1.  The URL has changed.

2.  Test configuration details have moved from within the `web` property to a top-level `test` property. Within the `test` property:

·       The values of the `testId`, ` emulatedDeviceId`, and `sslVersionId` properties have changed from integer to string.

·       The values within the `credentials` property array have changed from integer to string. Also, the `crednetials` property is only included in the response if at least one credential is assigned to the test, otherwise this property is omitted in the response.

·       The timestamp format of the `createdDate` and `modifiedDate` properties has changed from "YYYY-MM-DD HH:MM:SS" to "YYYY-MM-DDTHH:MM:SSZ" (ISO 8601 format with timezone).

·       The values of the `alertsEnabled`, ` allowGeolocation`, `allowMicAndCamera`, `allowUnsafeLegacyRenegotiation`, `bandwidthMeasurements`, `bgpMeasurements`, ` disableScreenshot`, `enabled`, `followRedirects`, ` includeHeaders`, `liveShare`, `mtuMeasurements`, `networkMeasurements`, `randomizedStartTime `, `savedEvent`, `useNtlm`, ` usePublicBgp`, and `verifyCertificate` properties have changed from integer to boolean.

·       The `flagOverrideAgentProxy` property has been renamed `overrideAgentProxy` and its value has changed from integer to string.

·       The values of the `protocol`, `probeMode`, and `authType` properties are now lowercase, and underscores are replaced with hyphens.

·       For example, in v6 `ipv6Policy` was "USE_AGENT_POLICY", in v7 it is "use-agent-policy"

·       The ` identifyAgentTrafficWithUserAgent`, ` isApi`, and `continuousMode` fields have been removed.

·       The `apiLinks` property has been replaced with the `_links` property.

3.  The ` webTransaction ` property, which contains the test results details, has been renamed to `results` and moved to the top-level. Within the `results` property:

·       The agent details, including `agentName`, `countryId`, and `agentId` are now grouped under the `agent` property of each object in the `results` array. The `agentId` value has changed from integer to string.

·       The timestamp format of the `date` property has changed to ISO 8601 format with timezone. 

·       The `permalink` property has been replaced with the `_links` > `appLink` > `href` property.

·       The `markers` property is only present if there is at least one marker in the results for this test, round, and agent. Otherwise, the `markers` property is omitted from the response.