Client Counts

Unique clients per device per day. This is the data behind the client chart in the monthly downtime report. For today's totals only, see Connected Clients; for per-client records, see Clients.

A client that roams between two access points at the same site is counted once against each, because the count is per device. Summing a site's rows therefore over-counts that site.

---

Daily client counts GET /v1/client_counts

Returns the number of distinct client MAC addresses seen per device per day, 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.

• 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

• daydate

  The day the clients were seen, YYYY-MM-DD.

• siteCodestring

  Site the device belongs to.

• deviceNamestring

  Display name of the device.

• gatewayIdstring

  Unique identifier of the device.

• clientCountinteger

  Distinct client MAC addresses seen on this device that day.

GET/v1/client_counts

cURL

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

JavaScript

const res = await fetch(
  'https://polaris.revlv.com/v1/client_counts?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/client_counts?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/client_counts', [
  'headers' => ['Authorization' => 'Bearer {token}'],
  'query'   => ['from' => '2026-04-01', 'to' => '2026-04-30'],
]);
echo $response->getBody();

Response

{
  "data": [
    {
      "day": "2026-04-01",
      "siteCode": "PH1-2026-549",
      "deviceName": "AP1_Inside of Barangay Hall Office",
      "gatewayId": "G1TA2FM00455A",
      "clientCount": 34
    },
    {
      "day": "2026-04-02",
      "siteCode": "PH1-2026-549",
      "deviceName": "AP1_Inside of Barangay Hall Office",
      "gatewayId": "G1TA2FM00455A",
      "clientCount": 28
    }
  ],
  "pageInfo": {
    "hasNextPage": false,
    "nextPageToken": ""
  }
}