---
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.

---

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