Skip to content

GET /measurements/{msm}/ping-stats/ ​

Get statistics about ping measurements for a specific probe, across a time resolution (none, hour, day, week). If no time range and resolution are specified, it defaults to the last 14 days with native resolution. Requests are rejected if the time range is too wide for the specified resolution. The current limits are: 21 days for native resolution, 2 months for hour resolution, 2 years for day resolution

GET /measurements/{msm}/ping-stats/ — anchors_only ​

Only show anchors.

GET /measurements/{msm}/ping-stats/ — format ​

GET /measurements/{msm}/ping-stats/ — msm ​

The unique measurement ID.

GET /measurements/{msm}/ping-stats/ — page ​

A page number within the paginated result set.

GET /measurements/{msm}/ping-stats/ — page_size ​

Number of results to return per page.

GET /measurements/{msm}/ping-stats/ — probe_ids ​

Comma-separated list of probe IDs or ID ranges.

GET /measurements/{msm}/ping-stats/ — public_only ​

Only show public probes.

GET /measurements/{msm}/ping-stats/ — resolution ​

Resolution of aggregation buckets.

GET /measurements/{msm}/ping-stats/ — start ​

Only consider results after this time.

GET /measurements/{msm}/ping-stats/ — stop ​

Only consider results before this time.

GET /api/v2/measurements/{msm}/ping-stats/​

Get statistics about ping measurements for a specific probe, across a time resolution (none, hour, day, week).

If no time range and resolution are specified, it defaults to the last 14 days with native resolution.

Requests are rejected if the time range is too wide for the specified resolution. The current limits are: 21 days for native resolution, 2 months for hour resolution, 2 years for day resolution

Try it out

Playground​

Authorization
Variables
Key
Value
Authorizations

Authorizations​

api-key
Type
API Key (header: Authorization)
or
or
anonymous

No authentication required — this endpoint can be accessed anonymously.

Parameters

Path Parameters

msm*

The unique measurement ID.

Type
integer
Required

Query Parameters

anchors_only

Only show anchors.

Type
string
format
Type
string
Valid values
"json""txt"
page

A page number within the paginated result set.

Type
integer
page_size

Number of results to return per page.

Type
integer
probe_ids

Comma-separated list of probe IDs or ID ranges.

Type
string
public_only

Only show public probes.

Type
string
resolution

Resolution of aggregation buckets.

Type
string
Valid values
"none""hour""day""week"
start

Only consider results after this time.

Type
string
Example"YYYY-mm-ddTHH:MM:SS"
Format
"date-time"
stop

Only consider results before this time.

Type
string
Example"YYYY-mm-ddTHH:MM:SS"
Format
"date-time"
Responses

Responses​

object
Format"uri"
Format"uri"
object[]
Required

The ID of the measurement.

The measurement type (ping).

Start time of the aggregation time range in Unix timestamp format.

Format"date-time"

Stop time of the aggregation time range in Unix timestamp format.

Format"date-time"

The ID of the probe.

Time resolution used for aggregation values.

  • none - Native-level results.
  • hour - Hourly buckets
  • day - Daily buckets
  • week - Weekly buckets
Valid values"none""hour""day""week"

Array of results: Unix timestamp, packets sent, packets received, RTT 5th, median and 95th percentile in milliseconds

Samples