---
title: "List segments"
method: GET
path: "/api/v1/log/segments"
---

# List segments

`GET /api/v1/log/segments`

List log segments whose start sequence falls within the given range.
Segments are the physical storage units of the log.

## Query parameters

- `start_seq` integer
- `end_seq` integer

## Response `200`

List of segments.

- SegmentsResponse — Response listing log segments.
  - `status` string, required
  - `segments` Segment[], required
    - `id` integer, required — Segment ID.
    - `startSeq` integer, required — First sequence number in this segment.
    - `startTimeMs` integer, required — Wall-clock timestamp (ms since epoch) when the segment was created.

## Other responses

- `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)
