> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/developer-tools/api-reference/logs-apis.md).

# Logs APIs

**Base URL:** `/api/v1/logs`

These endpoints provide access to Guardian system logs for operational monitoring and debugging, including filtered log retrieval and attribute discovery.

**Authentication:** All endpoints require a valid JWT Bearer token (`Authorization: Bearer <token>`). Obtain a token via `POST /accounts/login`. Permission `LOG_LOG_READ` is required for all endpoints.

***

## Endpoints

| Method | Endpoint           | Description                                      | Auth Required |
| ------ | ------------------ | ------------------------------------------------ | ------------- |
| POST   | `/logs`            | Return a filtered, paginated list of system logs | Yes           |
| GET    | `/logs/attributes` | Return a list of known log attribute values      | Yes           |
| GET    | `/logs/seq`        | Return the URL of the Seq log aggregation server | Yes           |

***

## Endpoint Details

* [Returning Logs](/developer-tools/api-reference/logs-apis/returning-logs.md)
* [Returning Log Attributes](/developer-tools/api-reference/logs-apis/returning-log-attributes.md)
* [Returns Seq URL](/developer-tools/api-reference/logs-apis/returns-seq-url.md)