Bluetooth

The Bluetooth and BTLE phys provide additional APIs for Bluetooth related data.

Bluetooth UUID names

DESC

Names Bluetooth service UUIDs from the Bluetooth ID list (btoidfile), as the web UI’s device details show them. Each UUID is a 16-bit assigned number (feaf), the same number in 32 bits (0000feaf), or the 128-bit Bluetooth base form (0000feaf-0000-1000-8000-00805f9b34fb); other entries are ignored.

{"uuids": ["feaf", "0000180f-0000-1000-8000-00805f9b34fb"]}
ROLES
readonly
ADDED
API added after 2026-10-R1
URI
/phy/bluetooth/uuid_names.json
/phy/bluetooth/uuid_names.ekjson
/phy/bluetooth/uuid_names.prettyjson
METHODS
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.

uuids list OPTIONAL

Up to 64 service UUIDs

RETURN
Dictionary of each known UUID, as it was given in lowercase, to its name; unknown UUIDs are left out.
RESPONSES
200
Success
400
Missing `uuids`, not a list, or more than 64 entries
DESC

The devices in the same related group as the BTLE device {DEVICEKEY}, the device itself included: the random addresses advertising the same payload, as the web UI’s BTLE Related Devices timeline shows them.

The list is empty when related devices are off (btle_related), or the device isn’t in a group.

ROLES
readonly
ADDED
API added after 2026-10-R1
URI
/phy/btle/related-of/{DEVICEKEY}/devices.json
/phy/btle/related-of/{DEVICEKEY}/devices.ekjson
/phy/btle/related-of/{DEVICEKEY}/devices.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.

RETURN
Array of devices
RESPONSES
200
Success
500
Invalid device key