Channels

Channel summary

DESC

Returns a summary of channels with observed traffic and devices, device counts per channel, and total channel coverage information.

Records are listed both by channel name (kismet.channeltracker.channel_map) and by frequency in kHz (kismet.channeltracker.frequency_map), for every phy that reports a frequency. Each record holds kismet.channelrec.channel, kismet.channelrec.frequency, the last signal seen (kismet.channelrec.signal), and three RRDs covering the last minute (per second), hour (per minute), and day (per hour):

FieldContent
kismet.channelrec.packets_rrdPackets per second
kismet.channelrec.data_rrdBytes of data per second
kismet.channelrec.device_rrdDevices active on the frequency (heard in the last 30 seconds)

The hour and day values are the average per second over each minute or hour. Before 2026-10-R1, packet and data counts were averaged rather than added up, so they read as about 1 per busy second, and device counts dropped each time the channels were read.

ROLES
readonly
URI
/channels/channels.json
/channels/channels.ekjson
/channels/channels.prettyjson
METHODS
GET POST
JSON
PARAMETERS

This endpoint takes additional parameters by using a `POST` request and supplying a JSON document or json form variable.

You can find more information about API parameters here.

fields field simplification OPTIONAL

Kismet can reduce the amount of information being processed and returned by an API by simplifying the fields to only return the data needed by the caller.

You can read more about the field simplification API and how to use it here.