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

# List logs

`GET /v1/logs`

## Query parameters

- `from` string
- `to` string
- `bucket` string
- `limit` integer
- `offset` integer
- `status` 'status' | 'failed' | 'stalled' | 'received' | 'rejected'

## Response `200`

Successful Response

- LogsResponse
  - `data` Log[]
    - `id` string
    - `created_at` integer
    - `updated_at` integer
    - `bucket_id` string
    - `input_id` string
    - `output_id` string
    - `internal` boolean — When internal output receives webhook, it forwards it to any connected agent (relay CLI, Docker agent or WebSocket connection)
    - `status_code` integer
    - `response_body` string
    - `response_headers` Headers — A hashmap of header keys and a list of values for each string, Go equivalent map[string][]string
    - `status` string — Request status, example values 'preparing', 'sent', 'failed', 'stalled', 'received', 'rejected'
    - `retries` integer — Retries taken so far
    - `headers` Headers — A hashmap of header keys and a list of values for each string, Go equivalent map[string][]string
    - `raw_query` string — raw query for example request to http://example.com?foo=bar is foo=bar
    - `method` string
    - `body` string
    - `ephemeral` boolean — This field is inherited from the bucket, if set - request/response body will not be set
  - `total` integer
  - `limit` integer
  - `offset` integer

---

[API](https://skmtc.dev/webhookrelay/apis/webhook-relay.md) · [All operations](https://skmtc.dev/webhookrelay/apis/webhook-relay/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webhookrelay/webhook-relay/revisions/ce8fd4d3cf19/schema)