Skip to main content
POST
/
api
/
occupancy
/
getOccupancyEventsForSensor
Get occupancy events for sensor
curl --request POST \
  --url https://api2.rhombussystems.com/api/occupancy/getOccupancyEventsForSensor \
  --header 'Content-Type: application/json' \
  --header 'x-auth-apikey: <api-key>' \
  --header 'x-auth-scheme: <x-auth-scheme>' \
  --data '
{
  "createdAfterMs": 1640908800000,
  "createdBeforeMs": 1640995200000,
  "limit": 100,
  "sensorUuid": "AAAAAAAAAAAAAAAAAAAAAA"
}
'
{
  "error": true,
  "errorMsg": "<string>",
  "events": [
    {
      "baseStationUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "batteryPercentage": 123,
      "bleDeviceUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "bleRssi": 123,
      "closeBaseStations": [
        "AAAAAAAAAAAAAAAAAAAAAA"
      ],
      "locationUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "lux": 123,
      "orgUuid": "AAAAAAAAAAAAAAAAAAAAAA",
      "stateChanged": true,
      "subLocationsHierarchyKey": "AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA",
      "tampered": true,
      "timestampMs": 123
    }
  ],
  "warningMsg": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.rhombus.community/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-auth-apikey
string
header
required

Your Rhombus API key. Must be accompanied by the x-auth-scheme header set to api-token (or partner-api-token for partner endpoints).

Headers

​
x-auth-scheme
enum<string>
default:api-token
required

Authentication scheme identifier. Use api-token for standard API key authentication, partner-api-token for partner API key authentication. Must be paired with the x-auth-apikey header containing your API key.

Available options:
api-token,
api,
partner-api-token,
partner-api

Body

application/json

Request object for getting occupancy events for a specific sensor.

​
createdAfterMs
integer<int64> | null

Filter events created after this timestamp (milliseconds since epoch)

Example:

1640908800000

​
createdBeforeMs
integer<int64> | null

Filter events created before this timestamp (milliseconds since epoch)

Example:

1640995200000

​
limit
integer<int32> | null

Maximum number of events to return

Example:

100

​
sensorUuid
string<RUUID> | null

base 64 (url-safe) uuid string

Example:

"AAAAAAAAAAAAAAAAAAAAAA"

Response

200 - application/json

OK

Response object containing occupancy events for a specific sensor.

​
error
boolean | null
​
errorMsg
string | null
​
events
object[] | null

List of occupancy events for the sensor

​
warningMsg
string | null
Last modified on May 23, 2026