Skip to main content
GET
List firmware versions

Updated 27 Oct 2026 12:07 · page 307a477

Authorizations

Authorization
string
header
required

Mint a token from the portal at Settings → API tokens. Send it as Authorization: Bearer avb_... on every request. Query-string tokens are NOT accepted — the URL ends up in access logs.

Query Parameters

building_id
string<uuid>

Restrict results to one building.

room_id
string<uuid>

Restrict results to one room.

firmware_status
enum<string>

Only versions with this status against their target.

Available options:
matches_target,
differs_from_target,
no_target,
not_reported

Response

Firmware versions, by make and model, most used first.

make
string
required

Empty when the devices haven't reported one.

model
string
required
firmware_version
string
required

Empty for devices that haven't reported firmware.

firmware_status
enum<string>
required

How the firmware compares with the target set for the device's make and model on the Firmware page: matches_target, differs_from_target, no_target (no target set) or not_reported (the device hasn't reported firmware).

Available options:
matches_target,
differs_from_target,
no_target,
not_reported
device_count
integer
required

Devices of this make and model on this firmware.

target_firmware_version
string

The target set for this make and model. Absent when none is set.