Skip to content

GET /measurements/{measurement_id}/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/{measurement_id}/ping-stats/ — anchors_only

Only show anchors.

GET /measurements/{measurement_id}/ping-stats/ — format

GET /measurements/{measurement_id}/ping-stats/ — measurement_id

The unique measurement ID.

GET /measurements/{measurement_id}/ping-stats/ — page

A page number within the paginated result set.

GET /measurements/{measurement_id}/ping-stats/ — page_size

Number of results to return per page.

GET /measurements/{measurement_id}/ping-stats/ — probe_ids

Comma-separated list of probe IDs or ID ranges.

GET /measurements/{measurement_id}/ping-stats/ — public_only

Only show public probes.

GET /measurements/{measurement_id}/ping-stats/ — resolution

Resolution of aggregation buckets.

GET /measurements/{measurement_id}/ping-stats/ — start

Only consider results after this time.

GET /measurements/{measurement_id}/ping-stats/ — stop

Only consider results before this time.

GET /api/v2/measurements/{measurement_id}/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
ripe-access
Type
API Key (cookie: crowd.token_key)
or
anonymous

No authentication required — this endpoint can be accessed anonymously.

Parameters

Path Parameters

measurement_id*

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