Skip to main content
POST
/
v1
/
monitoring
/
wan
/
ping-stats
Get Aggregated Ping Statistics
curl --request POST \
  --url https://api.altostrat.io/v1/monitoring/wan/ping-stats \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tunnels": [
    "9f9510bd-a425-4d9d-a7cf-f845a39e26db",
    "a1b2c3d4-e5f6-7890-1234-567890abcdef"
  ],
  "from": "2025-10-29T10:00:00Z",
  "to": "2025-10-29T11:00:00Z",
  "datapoints": 50
}'
{
  "timestamps": [
    1761619200000,
    1761619500000,
    1761619800000
  ],
  "data": [
    {
      "tunnel_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "latency": [
        12.5,
        13.1,
        null,
        12.8
      ],
      "packet_loss": [
        0,
        0,
        100,
        0.1
      ],
      "mdev": [
        1.2,
        1.5,
        null,
        1.3
      ]
    }
  ]
}

Authorizations

โ€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
โ€‹
from
string<date-time>
required

The start of the time window.

Example:

"2025-10-29T10:00:00Z"

โ€‹
to
string<date-time>
required

The end of the time window.

Example:

"2025-10-29T11:00:00Z"

โ€‹
tunnels
string<uuid>[]

An array of WAN Tunnel UUIDs to query. If omitted, an aggregate of all tunnels is returned.

Example:
[
  "9f9510bd-a425-4d9d-a7cf-f845a39e26db",
  "a1b2c3d4-e5f6-7890-1234-567890abcdef"
]
โ€‹
datapoints
integer
default:100

The desired number of data points in the response. The data will be aggregated to match this count, up to a maximum of 100.

Example:

50

Response

Time-series ping statistics for the requested tunnels.

โ€‹
timestamps
integer[]

An array of Unix timestamps (in milliseconds) corresponding to each data point.

Example:
[1761619200000, 1761619500000, 1761619800000]
โ€‹
data
object[]

An array of tunnel data series.