Skip to main content
POST
/
metrics
/
wan
/
ping-stats
Get Aggregated Ping Statistics
curl --request POST \
  --url https://v1.api.altostrat.io/metrics/wan/ping-stats \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "2025-10-29T10:00:00Z",
  "to": "2025-10-29T11:00:00Z",
  "tunnels": [
    "9f9510bd-a425-4d9d-a7cf-f845a39e26db",
    "a1b2c3d4-e5f6-7890-1234-567890abcdef"
  ],
  "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
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

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<int64>[]

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

Example:
[1761619200000, 1761619500000, 1761619800000]
​
data
object[]

An array of tunnel data series.