---
title: "Get logs within range"
method: POST
path: "/api/v1/logs/range"
tags: ["Post"]
---

# Get logs within range

`POST /api/v1/logs/range`

Get logs for conditions

## Request body

- QueryRequest
  - `attachment` boolean
  - `burst` integer — The number of logs that can be returned in one page and this can be greater or less than burst
  - `clusters` string[] — Get chunks belongs to clusters
  - `container` string — Use internally
  - `containers` string[] — Get chunks belongs to namespace and containers
  - `enableLogEntryFormat` boolean
  - `end` string — End time for query
  - `exclude` string
  - `id` string — Use internally
  - `include` string — Regular expression to search logs
  - `labels` ModelLabels[] — Get chunks belongs to namespaces and labels
  - `local` boolean — Use internally
  - `namespace` string — Use internally
  - `namespaces` string[] — Get chunks belongs to namespaces
  - `page` integer — The page number for the returned logs
  - `pod` string — Use internally
  - `pod_uid` string — Use internally
  - `pods` string[] — Get chunks belongs to namespace and pods
  - `setName` string — Use internally
  - `setNames` string[] — Get chunks belongs to namespace and set names(replicaset/statefulset)
  - `source` ModelSource
    - `path` string
    - `type` string
  - `sources` ModelSource[] — Get chunks belongs to namespace and log source
    - `path` string
    - `type` string
  - `start` string — Start time for query

## Response `200`

OK

- QueryResponse — Response wrapping series and logs from store.
  - `contents` string — logs in string
  - `pageInfo` ModelPageInfo — Page inforamtion.
    - `current` integer
    - `hasNext` boolean
    - `isPartialContents` boolean — partial logs are returned
    - `total` integer
  - `series` ModelSeries[] — Array contains Series.
    - `chunk_key` string
    - `lines` integer
    - `name` string
    - `samples` GithubComNaverLobsterPkgLobsterModelSample[]
      - `lines` integer
      - `size` integer
      - `timestamp` string
    - `size` integer

## Other responses

- `204` — No chunks
- `400` — Invalid parameters
- `405` — Method not allowed
- `429` — too many requests
- `500` — Failed to read logs
- `501` — Not supported version

---

[API](https://skmtc.dev/naver/apis/lobster-api-document.md) · [All operations](https://skmtc.dev/naver/apis/lobster-api-document/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/naver/lobster-api-document/revisions/20303c73d587/schema)