---
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
- `itemIds` string, required
- `groupIds` 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', 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.
    - `itemId` string, nullable, required — The unique identifier of the item the log is associated with (e.g., a south connector item ID). Can be `null` if the log is not associated with a specific item.
    - `itemName` string, nullable, required — The human-readable name of the item the log is associated with. Can be `null` if the log is not associated with a specific item.
    - `groupId` string, nullable, required — The unique identifier of the group the log is associated with (e.g., a south connector item group ID). Can be `null` if the log is not associated with a specific group.
    - `groupName` string, nullable, required — The human-readable name of the group the log is associated with. Can be `null` if the log is not associated with a specific group.
    - `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).

---

[API](https://skmtc.net/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.net/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimistiksas/oibus-api/versions/743d1b62f042/schema)