Skip to main content

Traffic

Wi-Fi traffic per device over time. This is the data behind the traffic chart in the monthly downtime report. One row per device per bucket, with the bytes that moved inside it.

Daily and monthly figures use Ruijie Cloud's own per-access-point totals wherever we have them (for Reyee access points, back to March 2026). Every other device and day uses Polaris's own measurement. That is the same choice the monthly downtime report makes, so the two agree. Hourly figures are Polaris's own measurement only, because Ruijie reports whole days: for Reyee access points they begin on 6 August 2026 and read well below the daily figures.

Each row holds only the bytes for that bucket, not a running total, so adding up rows over a range gives the total for that range.


Traffic series GET /v1/traffic​

Returns received and sent bytes per device per bucket, oldest first.

Query parameters​

  • fromdate

    First day of the range, YYYY-MM-DD in Philippine time. Omit both from and to for the current calendar month.

  • todate

    Last day of the range, inclusive. The range must be 92 days or less.

  • intervalstring

    Bucket width: day (default), hour, or month. A month bucket totals the days of that month that fall inside the range. Hourly data is kept for 90 days and is Polaris's own measurement only; daily and monthly are kept indefinitely.

  • gatewayIdstring

    Restrict to one device. Matches gatewayId on /v1/devices.

  • workspaceIdstring

    Scope to a single workspace. Must be one returned by GET /v1/workspaces. An id outside your token's set returns 403.

  • pageSizeinteger

    Rows per page, 1–5000. Defaults to 500.

  • pageTokenstring

    nextPageToken from the previous response.

Response object​

  • timetimestamp

    Start of the bucket.

  • siteCodestring

    Site the device belongs to.

  • deviceNamestring

    Display name of the device.

  • gatewayIdstring

    Unique identifier of the device.

  • rxBytesinteger

    Bytes received in the bucket (downlink, what reached the network).

  • txBytesinteger

    Bytes sent in the bucket (uplink, what left it).

GET/v1/traffic
curl "https://polaris.revlv.com/v1/traffic?from=2026-04-01&to=2026-04-30" \
-H "Authorization: Bearer {token}"
Response
{
"data": [
{
"time": "2026-04-01T00:00:00Z",
"siteCode": "PH1-2026-549",
"deviceName": "AP1_Inside of Barangay Hall Office",
"gatewayId": "G1TA2FM00455A",
"rxBytes": 21474836480,
"txBytes": 3221225472
},
{
"time": "2026-04-02T00:00:00Z",
"siteCode": "PH1-2026-549",
"deviceName": "AP1_Inside of Barangay Hall Office",
"gatewayId": "G1TA2FM00455A",
"rxBytes": 18253611008,
"txBytes": 2684354560
}
],
"pageInfo": {
"hasNextPage": false,
"nextPageToken": ""
}
}