Fob information & management

Get fob details

Get detailed information about a specific fob

get/v1/fobs/{id}

Request

Path parameters

idstring required

The primary key of fob

Example:66d025b301ebc903e80003ea

Response

Success response

idstring required

The primary key of fob

modelKey'fob' required

The model key of the fob

state'CONNECTED' | 'CONNECTING' | 'DISCONNECTED' required

Connection state of the device.

namestring required

The name of the device.

macstring required

The primary MAC address of the device.

awayState'ONLINE' | 'RECENTLY_SEEN' | 'NO_RECENT_HEARTBEAT' | 'DEVICE_LOST' required

Fob presence/away state.

buttonLabels'securityActions' | 'positionHint' required

Label style applied when this fob is rendered in button selection lists.

Example response

{
  "id": "66d025b301ebc903e80003ea",
  "state": "CONNECTED",
  "name": "Front Door",
  "mac": "24A43C3DFEB9",
  "awayState": "ONLINE",
  "buttonLabels": "securityActions",
  "featureFlags": {
    "buttons": [
      "arm",
      "disarm",
      "panic"
    ]
  },
  "wirelessConnectionState": {
    "signalState": {
      "signalQuality": 85,
      "signalStrength": -45
    },
    "batteryStatus": {
      "percentage": 95
    },
    "bridge": "66d025b301ebc903e80003ea"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.