# Logs (/docs/reference/api/logs)



Logs [#logs]

Log reads require read permission. Select a bounded time range with `start_time` and `end_time`.

GET `/v1/logs` [#get-v1logs]

List platform API requests captured by the service's internal request spans. Query
execution history belongs to the Queries screen; this endpoint focuses on HTTP
request activity.

Query parameters:

| Parameter      | Description                                                                           |
| -------------- | ------------------------------------------------------------------------------------- |
| `start_time`   | Inclusive lower bound.                                                                |
| `end_time`     | Inclusive upper bound.                                                                |
| `limit`        | Rows to return. Default `50`, max `200`.                                              |
| `offset`       | Rows to skip.                                                                         |
| `search`       | Free-text search across log ID, method, path, status, source, user agent, and errors. |
| `methods`      | Comma-separated HTTP methods, such as `GET,POST`.                                     |
| `status_codes` | Comma-separated HTTP status codes, such as `200,404,500`.                             |
| `sources`      | Comma-separated request sources: `ui`, `cli`, or `api`.                               |
| `user_agent`   | Exact user-agent value.                                                               |

Each log includes its span-based log ID, creation time, method, URL path, matched API
route, status code, source, duration, user agent, client version, request size,
trace ID, database, and structured error details when the
request failed. A bounded textual request body may be included for supported
requests (up to 8 KiB); response body content is not recorded.

Use an API key, a permitted workload token, or a user bearer token. Database-role keys support only the operations listed in [Authentication](/docs/reference/authentication#existing-database-roles).

Parameters:

| Field             | Location | Type    | Required | Notes                                                                                 |
| ----------------- | -------- | ------- | -------- | ------------------------------------------------------------------------------------- |
| `search`          | query    | string  | No       | Free-text search across log ID, method, path, status, source, user agent, and errors. |
| `methods`         | query    | string  | No       | Comma-separated HTTP methods, for example `GET,POST`.                                 |
| `status_codes`    | query    | string  | No       | Comma-separated HTTP status codes, for example `200,404,500`.                         |
| `levels`          | query    | string  | No       | Comma-separated request levels: `success`, `warning`, or `error`.                     |
| `sources`         | query    | string  | No       | Comma-separated request sources: `ui`, `cli`, or `api`.                               |
| `user_agent`      | query    | string  | No       | Exact user-agent value.                                                               |
| `host`            | query    | string  | No       | Case-insensitive substring of the request host.                                       |
| `paths`           | query    | string  | No       | Comma-separated exact request paths.                                                  |
| `min_duration_ms` | query    | integer | No       | Minimum request duration in milliseconds.                                             |
| `max_duration_ms` | query    | integer | No       | Maximum request duration in milliseconds.                                             |
| `start_time`      | query    | string  | No       | Inclusive lower bound using a RawTree-compatible datetime string.                     |
| `end_time`        | query    | string  | No       | Inclusive upper bound using a RawTree-compatible datetime string.                     |
| `limit`           | query    | integer | No       | Number of rows to return (default 50, max 200).                                       |
| `offset`          | query    | integer | No       | Number of rows to skip (default 0).                                                   |

Request:

```bash
# List platform API request logs.
curl -X GET "https://api.rawtree.com/v1/logs?database=analytics&start_time=2026-11-09T09%3A00%3A00Z&end_time=2026-11-09T10%3A00%3A00Z" \
  -H "Authorization: Bearer $RAWTREE_API_KEY"
```

Expected response: **HTTP 200**.

```json
{
  "logs": [],
  "has_more": false,
  "next_offset": null
}
```

Errors: `400`, `401`. See [API errors](/docs/reference/errors).