GET /isp-network/port-devices - kurnl Developer Docs

Internal API (/api/v1), dashboard JWT (Authorization: Bearer ...). Requires the reports:read permission. Admin callers must pass service_provider_id; provider users are scoped to their own provider automatically.

Endpoint

GET /api/v1/isp-network/port-devices

Query parameters

Parameter	Type	Required	Description
`service_provider_id`	UUID	Admin only	Provider to inspect (ignored/derived for provider users)

Returns one row per switch port with an active subscription for the provider. Link status is read live over SSH, the learned MAC comes from the switch SNMP FDB, the IP from the DHCP lease table, and the manufacturer from the MAC OUI.

Response — 200 OK

{
  "ports": [
    {
      "switch_id": "uuid",
      "switch_name": "string",
      "switch_host": "string",
      "interface": "ethernet1/12",
      "subscription_id": "uuid",
      "subscriber_id": "uuid",
      "subscriber_name": "string",
      "location_identifier": "string",
      "expected_download_mbps": 500,
      "expected_upload_mbps": 100,
      "seen_mac": "aa:bb:cc:dd:ee:ff",
      "seen_mac_count": 1,
      "ip_address": "10.x.x.x",
      "hostname": "string",
      "manufacturer": "AVM GmbH",
      "expected_mac": "aa:bb:cc:dd:ee:ff",
      "match_status": "match",
      "has_active_device": true
    }
  ]
}

match_status compares the learned MAC against the subscriber’s registered MAC: match | mismatch | unregistered (device seen, no MAC registered) | no_device. has_active_device is true when the link is up and a device is learned on the port. Enrichment is best-effort — fields degrade to null when SSH/SNMP/DHCP data is unavailable.