---
title: "Search logs"
method: GET
path: "/api/logs"
tags: ["Logs"]
---

# Search logs

`GET /api/logs`

Searches system logs with various filter parameters. If no time range is specified, defaults to the last 24 hours.

## Query parameters

- `start` string, required — Represents an instant in time as an ISO 8601 string.
- `end` string, required — Represents an instant in time as an ISO 8601 string.
- `levels` string, required
- `scopeIds` string, required
- `scopeTypes` string, required
- `messageContent` string, required
- `page` number, double

## Response `200`

Paginated list of log entries

- PageLogDTO — Represents a paginated response containing an array of elements.
  - `content` LogDTO[], required — The content of the page - an array of elements.
    - `timestamp` string, required — The timestamp of the log entry in ISO 8601 format.
    - `level` 'silent' | 'error' | 'warn' | 'info' | 'debug' | 'trace', required — Type representing a log level.
    - `scopeType` 'south' | 'north' | 'history-query' | 'internal' | 'web-server', required — Type representing a scope type.
    - `scopeId` string, nullable, required — The unique identifier of the scope (e.g., connector ID). Can be `null` if the log is not associated with a specific scope.
    - `scopeName` string, nullable, required — The human-readable name of the scope. Can be `null` if the log is not associated with a specific scope.
    - `message` string, required — The log message content, including details about the event or error.
  - `totalElements` number, double, required — The total number of elements across all pages.
  - `size` number, double, required — The size of the page, i.e., the maximum number of elements per page.
  - `number` number, double, required — The number of the current page, starting at 0.
  - `totalPages` number, double, required — The total number of pages (which can be 0 if there are no elements).

## Changes

- **2026-06-24** `2c78cb2da647` — 4 breaking, 3 warning
  - removed the required property `content/items/groupId` from the response with the `200` status
  - removed the required property `content/items/groupName` from the response with the `200` status
  - removed the required property `content/items/itemId` from the response with the `200` status
  - removed the required property `content/items/itemName` from the response with the `200` status
  - …3 more
- **2026-06-23** `9eab61b4f349` — 2 breaking, 5 info
  - added the new required `query` request parameter `groupIds`
  - added the new required `query` request parameter `itemIds`
  - removed the `web-server` enum value from the `content/items/scopeType` response property for the response status `200`
  - added the required property `content/items/groupId` to the response with the `200` status
  - …3 more
- **2026-06-18** `f4c06376e038` — 2 breaking, 2 warning
  - removed the required property `content/items/itemId` from the response with the `200` status
  - removed the required property `content/items/itemName` from the response with the `200` status
  - deleted the `query` request parameter `itemIds`
  - added the new `web-server` enum value to the `content/items/scopeType` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/optimistiksas/apis/oibus-api/changes/api/logs/get.md)

---

[API](https://skmtc.dev/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.dev/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optimistiksas/oibus-api/revisions/2c78cb2da647/schema)