Results and Latest

Fetching Measurement Results

Get the full result history for a measurement:

GET /api/v2/measurements/2000000/results/?start=1431459634

Try it out

Query Parameters

Parameter	Description
start	Lower time limit (UNIX timestamp)
stop	Upper time limit (UNIX timestamp)
probe_ids	Comma-separated list of probe IDs to filter by

TIP

None of the generic query parameters (fields, page, etc.) work on the results endpoint.

Large Responses

Results can be very large (e.g. a year of per-minute measurements = 525,600 results). RIPE Atlas streams the response, sending data as soon as the first result is available rather than waiting for the full response to be assembled.

The response format is documented in detail in the Measurement Result Format section.

Latest Results

Get the most recent result from each probe:

GET /api/v2/measurements/2000000/latest/?probe_ids=10006

Try it out

Output Format

Results are returned as key/value pairs keyed by probe ID:

{
    "12345": [<result>],
    "67890": [<result>]
}

Access the latest result for a specific probe: data["12345"][0]

Versioning

Request up to 10 previous results per probe with the versions parameter (1-10):

/api/v2/measurements/{id}/latest/?versions=3

Results are in reverse chronological order: index [0] is the most recent.

Filtering

Filter by probe ID with probe_ids=123,456. Specifying a probe not in the measurement returns an empty set.

Caching

Results are cached for 5 minutes — data may lag the actual state by up to 5 minutes.