# Guest Devices

# Get Guest Devices

By using this API endpoint, it is possible to get the list of guest devices.

Please note that you cannot get more than 100 records per request. In case you need to get more than 100 records, then you should make more than one request.

# Endpoint

GET /guest-devices

# Parameters

Name Type Description
guest_id string End-user ID
mac string Guest device MAC address
online boolean If the guest device is currently online or not. true / false
created_at date Returns entries created after the entered date (format: yyyy-mm-dd)
per_page integer The number of records returned. Default is 10, maximum is 100

# Response

TIP

HTTP/1.1 200 OK

{
  "data": [
    {
      "guest_id": "NgqovXZLDOy",
      "type_name": "Desktop",
      "mac": "f4:5c:89:94:d4:2b",
      "ip": "95.6.16.57",
      "user_agent": null,
      "description": "Macintosh",
      "platform": "OS X",
      "browser": "Mozilla",
      "connection_status": "Offline",
      "connection_status_value": 0,
      "total_downloaded_data": "1.64 GB",
      "total_uploaded_data": "141.72 MB",
      "last_seen_time": "2017-02-14T10:27:46+00:00",
      "created_at": "2017-01-04T11:41:29+00:00",      
      "updated_at": "2017-02-14T10:46:46+00:00"
    }
  ],

  "links": {
    "first": "https://api.iperawifi.com/api/v1/guests-devices?page=1",
    "last": null,
    "prev": null,
    "next": "https://api.iperawifi.com/api/v1/guests-devices?page=2"
  },

  "meta": {
    "current_page": 1,
    "from": 1,
    "path": "https://api.iperawifi.com/api/v1/guests-devices",
    "per_page": 10,
    "to": 2
  }
}

# Get Guest Device Count

By using this API endpoint, it is possible to get the count of the guest devices.

# Endpoint

GET /guest-devices/count

# Parameters

Name Type Description
guest_id string End-user ID
mac string Guest device MAC address
online boolean If the guest device is currently online or not. true / false
created_at date Returns count of the entries created after the entered date (format: yyyy-mm-dd)

# Response

TIP

HTTP/1.1 200 OK

{
  "count": 1000
}
Last Updated: 4/16/2025, 8:01:29 AM