List connected users in a location

get

Authorizations

cookieapi_token

defguard_sessionstringRequired

Path parameters

location_idinteger · int64Required

ID of the location.

Query parameters

fromstringOptional

Start of the reported period as an RFC 3339 timestamp. Defaults to 1 hour ago.

pageinteger · int32Optional

Page number. Defaults to 1.

per_pageinteger · int32Optional

Number of items per page, from 1 to 100. Defaults to 50.

Responses

200

Paginated list of connected users.

application/json

Envelope returned by paginated endpoints.

401

Session is missing or invalid.

application/json

403

Requires admin privileges.

application/json

404

Network not found.

application/json

500

Unable to get connected users.

application/json

get/api/v1/network/{location_id}/stats/connected_users

HTTPcURLJavaScriptPython

GET /api/v1/network/{location_id}/stats/connected_users HTTP/1.1
Accept: */*

{
  "data": [
    {
      "connected_at": "2026-08-11T04:52:00.718Z",
      "connected_devices_count": 1,
      "first_name": "text",
      "full_name": "text",
      "last_name": "text",
      "public_ip": "text",
      "stats": [
        {
          "collected_at": null,
          "download": null,
          "upload": null
        }
      ],
      "total_download": 1,
      "total_upload": 1,
      "user_id": 1,
      "vpn_ips": [
        "text"
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "next_page": null,
    "page_size": 1,
    "total_items": 1,
    "total_pages": 1
  }
}