# M-lab Bandwidth
This data call returns a set of all the measured network bandwidths for a certain resource. The maximum time window for this datacall is 7 days.
The data is based on active host measurements collected by the Measurement Lab platform (M-Lab (opens new window)).
The bandwidth of a host is determined as the maximum network throughput value for all the tests/measurements performed by that host during the specified time period.
The value of the measurement throughput is computed as the number of octets transmitted between the host and the chosen M-Lab server, divided by their transfer time.
The measurements are commonly ran using the M-Lab Network Detection Tool (NDT (opens new window)). Note there is typically at least a 24-hour delay between data collection and data publication
The results published, including host details are covered by the M-Lab acceptable use policy (opens new window).
# Parameters
| Key | Value | Info | Required | Default value |
|---|---|---|---|---|
| resource | IPv4 Prefix, IPv4 address, IPv6 prefix, IPv6 address, IP range or country code | Defines the resource that the query is performed for. | YES | |
| starttime | ISO8601 or Unix timestamp | Defines the starttime for the query. | NO | endtime - 7d |
| endtime | ISO8601 or Unix timestamp | Defines the endtime for the query. | NO | today |
# Data Output
| Key | Info |
|---|---|
| bandwidths | List of observed bandwidths in Mbps units. One value per host. |
| query_starttime | Defines the start of the time interval covered in the query. |
| query_endtime | Defines the end of the time interval covered in the query. |
| resource | Defines the resource used in the query. |
# Code Examples
curl --location --request GET "https://stat.ripe.net/data/mlab-bandwidth/data.json?resource=cy&starttime=2020-08-21&endtime=2020-08-27"
var requestOptions = {
method: 'GET',
};
fetch("https://stat.ripe.net/data/mlab-bandwidth/data.json?resource=cy&starttime=2020-08-21&endtime=2020-08-27", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));