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)

Wi-Fi data and management frames also count retries (frames with the retry bit set; control frames, duplicates, and frames with a bad checksum aren’t counted):

FieldContent
kismet.channelrec.retry_framesData and management frames counted
kismet.channelrec.retry_countOf those, retries
kismet.channelrec.retry_frames_rrdCounted frames per second
kismet.channelrec.retry_rrdRetries per second

The retry percentage over any period is retry_rrd divided by retry_frames_rrd.

Frequency records also flag likely interference (see dot11_channel_noise in tuning); in channel records these are always 0:

FieldContent
kismet.channelrec.noise1 while the frequency is flagged
kismet.channelrec.noise_sinceWhen it was flagged
kismet.channelrec.noise_scoreThe last window’s score
kismet.channelrec.noise_retry_pctThe last window’s retry percentage, the worst transmitter left out
kismet.channelrec.noise_framesFrames in the last window
kismet.channelrec.noise_retriesRetries in the last window
kismet.channelrec.noise_retry_txTransmitters with 2 or more retries in the last window
kismet.channelrec.noise_baseline_pctThe usual retry percentage, learned from windows which weren’t flagged; -1 until learned

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.