---
title: "Scan entries"
method: GET
path: "/api/v1/log/scan"
---

# Scan entries

`GET /api/v1/log/scan`

Scan log entries for a given key within an optional sequence range.

Supports **long-polling**: set `follow=true` to hold the connection open
until new data arrives or `timeout_ms` elapses (default 30 000 ms). This
is useful for tailing a log stream in near-real-time.

## Query parameters

- `key` string, required
- `start_seq` integer
- `end_seq` integer
- `limit` integer
- `follow` boolean
- `timeout_ms` integer

## Response `200`

Scan results.

- ScanResponse — Response containing scanned log entries for a key.
  - `status` string, required
  - `key` string, byte — The key that was scanned, base64-encoded.
  - `values` Value[], required — Matching log entries.
    - `sequence` integer, required — Global sequence number of this entry.
    - `value` string, byte, required — Entry payload, base64-encoded.

## Other responses

- `400` — Invalid input (e.g. missing `key` parameter).
- `500` — Internal server error.

## Changes

- **2026-02-12** `792e23c43301` — 2 breaking
  - the `key` response's property type/format changed from `object`/`` to `string`/`byte` for status `200`
  - removed the required property `key/value` from the response with the `200` status

[Change history](https://skmtc.dev/opendata-oss/apis/opendata-log-api/changes/api/v1/log/scan/get.md)

---

[API](https://skmtc.dev/opendata-oss/apis/opendata-log-api.md) · [All operations](https://skmtc.dev/opendata-oss/apis/opendata-log-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opendata-oss/opendata-log-api/revisions/792e23c43301/schema)