---
title: "List Request Logs"
method: GET
path: "/request-logs"
---

# List Request Logs

`GET /request-logs`

## Request

- Base URL: `https://api.dashboard.knotapi.com`
- URL: `https://api.dashboard.knotapi.com/request-logs`
- Auth: HTTP bearer

List API and webhook request logs.

## Query parameters

- `environment` 'development' | 'production', required
- `start` string, date-time
- `end` string, date-time
- `type` 'request' | 'webhook'
- `session_id` string, uuid
- `task_id` integer
- `external_user_id` string
- `event` string
- `status_code` integer
- `limit` integer
- `next_cursor` string

## Response `200`

Successful request.

- object
  - `data` RequestLog[], required: Request logs, newest first.
    - `id` integer, required: Unique identifier for the request log.
    - `type` 'request' | 'webhook', required: `request` for an API request to Knot. `webhook` for a webhook delivery attempt to your endpoint. Each webhook retry is a separate log.
    - `datetime` string, date-time, required: When the request was made, in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
    - `method` string, nullable, required: HTTP method of the request.
    - `path` string, nullable, required: For `request` logs, the Knot API path that was called, including its query string. Sensitive query parameter values are masked. `null` for `webhook` logs.
    - `url` string, nullable, required: For `webhook` logs, the endpoint URL Knot sent the webhook to. Query parameter values and credentials are masked. `null` for `request` logs.
    - `event` string, nullable, required: For `webhook` logs, the webhook event. `null` for `request` logs.
    - `status_code` integer, required: HTTP status code of the response. For `webhook` logs, this is the status code your endpoint returned. Knot records `504` when your endpoint times out or can't be reached.
    - `latency_ms` integer, nullable, required: Time taken to respond, in milliseconds.
    - `session_id` string, nullable, required: The session the log belongs to, if any.
    - `task_id` integer, nullable, required: The task the log belongs to, if any.
    - `external_user_id` string, nullable, required: Your unique identifier for the user, if any.
  - `next_cursor` string, nullable, required: Cursor for the next page, or `null` if there are no more logs.
  - `limit` integer, required: Maximum number of logs returned per page.

## Other responses

- `400`: Invalid request.
- `401`: Unauthorized request.
- `403`: Forbidden request.
- `429`: Too many requests.
- `500`: Internal server error.

## Changes

- **2026-11-03** `f10ecfa12c00`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/knotapi/apis/knot-api/changes/request-logs/get.md)

---

[API](https://skmtc.dev/knotapi/apis/knot-api.md) - [All operations](https://skmtc.dev/knotapi/apis/knot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knotapi/apis/knot-api/revisions/f10ecfa12c00?raw)