Traffic

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

Bytes are deltas within the bucket, never running counters, so summing 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. Hourly data is kept for 90 days; 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

curl "https://polaris.revlv.com/v1/traffic?from=2026-04-01&to=2026-04-30" \
  -H "Authorization: Bearer {token}"

JavaScript

const res = await fetch(
  'https://polaris.revlv.com/v1/traffic?from=2026-04-01&to=2026-04-30',
  { headers: { 'Authorization': 'Bearer {token}' } },
);
const { data } = await res.json();

Go

req, _ := http.NewRequest("GET",
  "https://polaris.revlv.com/v1/traffic?from=2026-04-01&to=2026-04-30", nil)
req.Header.Add("Authorization", "Bearer {token}")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))

PHP

$response = $client->get('https://polaris.revlv.com/v1/traffic', [
  'headers' => ['Authorization' => 'Bearer {token}'],
  'query'   => ['from' => '2026-04-01', 'to' => '2026-04-30'],
]);
echo $response->getBody();

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": ""
  }
}