---
title: "List logs"
method: GET
path: "/logs"
tags: ["Logs"]
---

# List logs

`GET /logs`

List logs matching the provided filters. Logs are paginated by start and end timestamps.
There are more logs to fetch if `hasMore` is true in the response. Provide the `nextStartTime`
and `nextEndTime` timestamps as the `startTime` and `endTime` query parameters to fetch the next page of logs.

You can query for logs across multiple resources, but all resources must be in the same region and belong to the same owner.

## Query parameters

- `ownerId` string, required
- `startTime` string, date-time
- `endTime` string, date-time
- `direction` 'forward' | 'backward'
- `resource` string[], required
- `instance` string[]
- `host` string[]
- `statusCode` string[]
- `method` string[]
- `task` string[]
- `taskRun` string[]
- `level` string[]
- `type` string[]
- `text` string[]
- `path` string[]
- `limit` integer — Defaults to 20

## Response `200`

A collection of logs with pagination metadata

- object — A run of a cron job
  - `hasMore` boolean, required — True if there are more logs to fetch
  - `nextStartTime` string, date-time, required — The start time to use in the next query to fetch the next set of logs
  - `nextEndTime` string, date-time, required — The end time to use in the next query to fetch the next set of logs
  - `logs` Schema[], required — unresolved $ref

## Other responses

- `400` — The request could not be understood by the server.
- `401` — Authorization information is missing or invalid.
- `403` — You do not have permissions for the requested resource.
- `404` — Unable to find the requested resource.
- `406` — Unable to generate preferred media types as specified by Accept request header.
- `410` — The requested resource is no longer available.
- `429` — Rate limit has been surpassed.
- `500` — An unexpected server error has occurred.
- `503` — Server currently unavailable.

---

[API](https://skmtc.dev/render/apis/render-public-api.md) · [All operations](https://skmtc.dev/render/apis/render-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/render/render-public-api/revisions/80e0ff74d033/schema)