KNknotapi

Get Request Log By ID

Changed on

Get a request log by ID.

get/request-logs/{id}

Request

  • Base URL
    https://api.dashboard.knotapi.com
  • URL
    https://api.dashboard.knotapi.com/request-logs/{id}
  • Auth
    HTTP bearer

Path parameters

idinteger required
Example:98231774

Unique identifier for the request log.

Query parameters

environment'development' | 'production' required
Example:development

The environment to read logs from. Must match your access token's environment.

Response

Successful request.

idinteger 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.

datetimestring date-time required

When the request was made, in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).

methodstring nullable required

HTTP method of the request.

pathstring 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.

urlstring nullable required

For webhook logs, the endpoint URL Knot sent the webhook to. Query parameter values and credentials are masked. null for request logs.

eventstring nullable required

For webhook logs, the webhook event. null for request logs.

status_codeinteger 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_msinteger nullable required

Time taken to respond, in milliseconds.

session_idstring nullable required

The session the log belongs to, if any.

task_idinteger nullable required

The task the log belongs to, if any.

external_user_idstring nullable required

Your unique identifier for the user, if any.

request_bodystring nullable required

The request body as a string. Card data, credentials, tokens, email addresses, phone numbers, and addresses are replaced by ********. external_user_id, merchant names, and account details are not masked. For request logs, this is the body you sent to Knot. For webhook logs, this is the webhook payload Knot sent to your endpoint.

request_body_truncatedboolean required

true if request_body was cut to 8 KB.

response_bodystring nullable required

The response body as a string, masked like request_body. For request logs, this is Knot's response. For webhook logs, this is your endpoint's response. Successful Knot responses larger than 5 KB are not stored and appear as response too large.

response_body_truncatedboolean required

true if response_body was cut to 8 KB.

Example response

{
  "id": 98231774,
  "type": "webhook",
  "datetime": "2026-10-15T14:32:08Z",
  "method": "POST",
  "url": "https://example.com/webhooks/knot?token=********",
  "event": "AUTHENTICATED",
  "status_code": 200,
  "latency_ms": 184,
  "session_id": "915efe72-5136-4652-9a1f-d9d48003c102",
  "task_id": 7754123,
  "external_user_id": "user-123"
}

Changes