AI Chat7

AI Management3

AI Operators14

AI Saved Prompts5

Alarm Categories5

Alarms10

Asset Management Schema5

Authentication2

Background Tasks1

Chat Bots7

Cloud Connectors1

Data Collection10

DCI Summary Tables7

Event Forwarders7

Event Processing Policy8

Event Templates5

Find2

Geo Areas5

Grafana8

Image Library6

Incidents10

Log Parsers2

Logs5

Notification Channels9

Object Categories5

Object Tools10

Objects83

Scheduled Tasks6

Script Library6

Server8

Server Actions5

SNMP MIB2

SSH Keys5

TCP Proxy2

Traffic Observers1

Two-Factor Authentication9

User Groups5

Users9

Web Service Definitions5

Logs

Query log

Execute a log query and return the requested page of records. Each request is self-contained - there is no server-side query state to open or close.

All column filters are combined with AND; use a filter of type set to combine conditions on the same column with OR. Filter and ordering column names are validated against the log definition.

Numeric filter values for timestamp columns are UNIX timestamps (milliseconds for columns of millisecond resolution). A string value is parsed as a timestamp and accepts ISO 8601, a UNIX timestamp, a relative offset such as -30m, or now.

Records are returned as objects keyed by column name, with values typed according to the column type: coded and integer columns as numbers, timestamps as ISO 8601 strings, everything else as strings. Detail columns are not included.

Paging is implemented by re-executing the query and skipping records, so a large offset is expensive; offset + limit may not exceed 100000.

post/v1/logs/{log-name}/query

Request body

offsetinteger

Number of records to skip

limitinteger

Maximum number of records to return (1 to 10000; offset + limit may not exceed 100000)

Response

Query executed successfully

offsetinteger

Number of records skipped

countinteger

Number of records returned

recordsobject[]

Log records as objects keyed by column name

Changes

Changed in 8 of the 115 revisions of this API.343

Sep 21, 20262827204d68d91See the full diff
- ●
  added the new Room enum value to the /// response property for the response status
  response-property-enum-value-added
Sep 6, 2026c4fbee63f8433See the full diff
- ●
  added the new CoolingZone enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new Facility enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new PowerDomain enum value to the /// response property for the response status
  response-property-enum-value-added
Aug 19, 202604731b73e7231See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
Aug 17, 2026070b10a450e21See the full diff
- ▲
  the //// response's property type changed from integer to string for status
  response-property-type-changed
Aug 12, 2026595d081990401See the full diff
- ▲
  the //// response's property type changed from string to integer for status
  response-property-type-changed
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 12, 202647655614e52c1See the full diff
- ▲
  the //// response's property type changed from integer to string for status
  response-property-type-changed
Aug 11, 20263654edb8211f1See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
Aug 4, 2026d92822087da71See the full diff
- ○
  endpoint added
  endpoint-added

Full history