Bumblebee docs

Sensor values

Use these API endpoints to read sensor values.

Current version: 1

Example sensor value

{
  "sensor_value": {
    "id": "Abc123",
    "recorded_at": "2025-01-01T13:00:00.000+01:00",
    "sensor1_raw_value": 123,
    "sensor2_raw_value": 123,
    "sensor3_raw_value": 123,
    "asset": {
      "id": "Ref001",
      "url": "https://my.iobee.eu/api/assets/Ref001"
    }
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<sensor-value>
  <id>Abc123</id>
  <recorded-at type="dateTime">2025-01-01T13:00:00+01:00</recorded-at>
  <sensor1-raw-value type="integer">123</sensor1-raw-value>
  <sensor2-raw-value type="integer">123</sensor2-raw-value>
  <sensor3-raw-value type="integer">123</sensor3-raw-value>
  <asset>
    <id>Ref001</id>
    <url>https://my.iobee.eu/api/assets/Ref001</url>
  </asset>
</sensor-value>
sensor1_raw_value The raw value of sensor 1 ranging from 0 to 4095.
sensor2_raw_value The raw value of sensor2 ranging from 0 to 4095.
sensor3_raw_value The raw value of sensor3 ranging from 0 to 4095.
recorded_at When the sensor value was recorded.
asset The asset this sensor value belongs to.
asset/id The id of the asset.
asset/url The url of the asset.

Index

Gets a list with all sensor values. This is a paginated response.

URL
GET https://my.iobee.eu/api/sensor_values

Response

Status
200 - OK
Body
{
  "sensor_values": [
    {
      "id": "Abc123",
      "recorded_at": "2025-01-01T13:00:00.000+01:00",
      "sensor1_raw_value": 123,
      "sensor2_raw_value": 123,
      "sensor3_raw_value": 123,
      "asset": {
        "id": "Ref001",
        "url": "https://my.iobee.eu/api/assets/Ref001"
      }
    }
  ],
  "_next_page": {
    "token": "eyJzIjoxNzM1NzMyODAwLjAsImkiOm51bGx9",
    "empty": true,
    "remaining": 0,
    "url": "https://my.iobee.eu/docs/api/sensor_values?page_token=eyJzIjoxNzM1NzMyODAwLjAsImkiOm51bGx9"
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<hash>
  <sensor-values type="array">
    <sensor-value>
      <id>Abc123</id>
      <recorded-at type="dateTime">2025-01-01T13:00:00+01:00</recorded-at>
      <sensor1-raw-value type="integer">123</sensor1-raw-value>
      <sensor2-raw-value type="integer">123</sensor2-raw-value>
      <sensor3-raw-value type="integer">123</sensor3-raw-value>
      <asset>
        <id>Ref001</id>
        <url>https://my.iobee.eu/api/assets/Ref001</url>
      </asset>
    </sensor-value>
  </sensor-values>
  <_next-page>
    <token>eyJzIjoxNzM1NzMyODAwLjAsImkiOm51bGx9</token>
    <empty type="boolean">true</empty>
    <remaining type="integer">0</remaining>
    <url>https://my.iobee.eu/docs/api/sensor_values?page_token=eyJzIjoxNzM1NzMyODAwLjAsImkiOm51bGx9</url>
  </_next-page>
</hash>

Show

Gets the specified sensor value.

URL
GET https://my.iobee.eu/api/sensor_values/:id

Response

Status
200 - OK
Body
{
  "sensor_value": {
    "id": "Abc123",
    "recorded_at": "2025-01-01T13:00:00.000+01:00",
    "sensor1_raw_value": 123,
    "sensor2_raw_value": 123,
    "sensor3_raw_value": 123,
    "asset": {
      "id": "Ref001",
      "url": "https://my.iobee.eu/api/assets/Ref001"
    }
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<sensor-value>
  <id>Abc123</id>
  <recorded-at type="dateTime">2025-01-01T13:00:00+01:00</recorded-at>
  <sensor1-raw-value type="integer">123</sensor1-raw-value>
  <sensor2-raw-value type="integer">123</sensor2-raw-value>
  <sensor3-raw-value type="integer">123</sensor3-raw-value>
  <asset>
    <id>Ref001</id>
    <url>https://my.iobee.eu/api/assets/Ref001</url>
  </asset>
</sensor-value>
URL
GET https://my.iobee.eu/api/assets/:id/sensor_values

Response

Status
200 - OK
Body
{
  "sensor_values": [
    {
      "id": "Abc123",
      "recorded_at": "2025-01-01T13:00:00.000+01:00",
      "sensor1_raw_value": 123,
      "sensor2_raw_value": 123,
      "sensor3_raw_value": 123
    }
  ],
  "_next_page": {
    "token": "eyJzIjoxNzM1NzMyODAwLjAsImkiOm51bGx9",
    "empty": true,
    "remaining": 0,
    "url": "https://my.iobee.eu/docs/api/sensor_values?page_token=eyJzIjoxNzM1NzMyODAwLjAsImkiOm51bGx9"
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<hash>
  <sensor-values type="array">
    <sensor-value>
      <id>Abc123</id>
      <recorded-at type="dateTime">2025-01-01T13:00:00+01:00</recorded-at>
      <sensor1-raw-value type="integer">123</sensor1-raw-value>
      <sensor2-raw-value type="integer">123</sensor2-raw-value>
      <sensor3-raw-value type="integer">123</sensor3-raw-value>
    </sensor-value>
  </sensor-values>
  <_next-page>
    <token>eyJzIjoxNzM1NzMyODAwLjAsImkiOm51bGx9</token>
    <empty type="boolean">true</empty>
    <remaining type="integer">0</remaining>
    <url>https://my.iobee.eu/docs/api/sensor_values?page_token=eyJzIjoxNzM1NzMyODAwLjAsImkiOm51bGx9</url>
  </_next-page>
</hash>

Options

Include message info

?include_message_info=t

You can request to receive metadata about the sigfox message. If this option is set to true in index or show, Bumblebee will include a message_info node: 

{
  "message_info": {
    "id": "Abc123",
    "sent_at": "2025-01-01T13:00:00.000+01:00",
    "created_at": "2025-01-01T13:00:00.000+01:00",
    "recorded_at": "2025-01-01T13:00:00.000+01:00",
    "snr": 1.234,
    "rssi": 1.234,
    "sequence": 123,
    "message_number": 123,
    "external_io": 1,
    "day_number": 123
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<message-info>
  <id>Abc123</id>
  <sent-at type="dateTime">2025-01-01T13:00:00+01:00</sent-at>
  <created-at type="dateTime">2025-01-01T13:00:00+01:00</created-at>
  <recorded-at type="dateTime">2025-01-01T13:00:00+01:00</recorded-at>
  <snr type="float">1.234</snr>
  <rssi type="float">1.234</rssi>
  <sequence type="integer">123</sequence>
  <message-number type="integer">123</message-number>
  <external-io type="integer">1</external-io>
  <day-number type="integer">123</day-number>
</message-info>
recorded_at When the data was recorded by the node.
sent_at When the message was sent by the node.
(Please note: If a message is being sent again, the sent_at will contain the timestamp for when the message was sent again, not the original timestamp)
snr The signal-to-noise ratio in dB.
rssi The received signal strength indicator in dBm.
sequence The Sigfox sequence number of the message.
message_number The Bumblebee sequence number of the message.
external_io The state of the external i/o at the time of the message. A value of 0 means the external i/o is active, a value of 1 means the external i/o is inactive. This value will be nil if the node version is below 0.9
created_at When we received this message from Sigfox.

Include node configuration

?include_node_configuration=t

You can request to receive the configuration that was used by the node to sent the message. If this option is set to true in index or show, Bumblebee will include a message_info node containing a node_configuration node.

Note that if this option is set to true, include_message_info will also be implicitly set to true. 

{
  "message_info": {
    "id": "Abc123",
    "sent_at": "2025-01-01T13:00:00.000+01:00",
    "created_at": "2025-01-01T13:00:00.000+01:00",
    "recorded_at": "2025-01-01T13:00:00.000+01:00",
    "snr": 1.234,
    "rssi": 1.234,
    "sequence": 123,
    "message_number": 123,
    "external_io": 1,
    "day_number": 123,
    "node_configuration": {
      "id": "Ref001",
      "name": "Name",
      "behavior_id": "Abc123",
      "behavior_version": 3,
      "behavior_profile": "unless",
      "trigger_type": "motion"
    }
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<message-info>
  <id>Abc123</id>
  <sent-at type="dateTime">2025-01-01T13:00:00+01:00</sent-at>
  <created-at type="dateTime">2025-01-01T13:00:00+01:00</created-at>
  <recorded-at type="dateTime">2025-01-01T13:00:00+01:00</recorded-at>
  <snr type="float">1.234</snr>
  <rssi type="float">1.234</rssi>
  <sequence type="integer">123</sequence>
  <message-number type="integer">123</message-number>
  <external-io type="integer">1</external-io>
  <day-number type="integer">123</day-number>
  <node-configuration>
    <id>Ref001</id>
    <name>Name</name>
    <behavior-id>Abc123</behavior-id>
    <behavior-version type="integer">3</behavior-version>
    <behavior-profile type="symbol">unless</behavior-profile>
    <trigger-type type="symbol">motion</trigger-type>
  </node-configuration>
</message-info>
id The id of the configuration that was active.
name The name of the configuration that was active.
behavior_id The ID of the behavior that was active.
behavior_version The version of the behavior that was active. The version will change every time you alter the behavior.
behavior_profile The profile of the behavior that was active, the value is one of: default or unless
trigger_type The type of trigger that caused this message to be sent, only present if behavior_profile is unless