---
title: "List centralized event log entries"
method: GET
path: "/event-logs"
tags: ["events"]
---

# List centralized event log entries

`GET /event-logs`

Returns centralized event log entries matching the filter criteria. Manager or admin only.

## Query parameters

- `remoteNode` string
- `kind` string
- `type` string
- `dagName` string
- `dagRunId` string
- `attemptId` string
- `sessionId` string
- `userId` string
- `model` string
- `startTime` string, date-time
- `endTime` string, date-time
- `limit` integer
- `paginationMode` 'offset' | 'cursor'
- `offset` integer
- `cursor` string

## Response `200`

List of event log entries

- EventLogsResponse — Response containing centralized event log entries
  - `entries` EventLogEntry[], required — List of event log entries
    - `id` string, required — Unique identifier for this event
    - `schemaVersion` integer, required — Schema version of the event envelope
    - `occurredAt` string, date-time, required — When the event occurred
    - `recordedAt` string, date-time, required — When the event was recorded by the producer
    - `kind` string, required — High-level event kind (e.g., dag_run, llm_usage)
    - `type` string, required — Specific event type (e.g., dag.run.failed)
    - `sourceService` string, required — Service that produced the event
    - `sourceInstance` string — Specific producer instance identifier
    - `dagName` string — DAG name for DAG-run events
    - `dagRunId` string — DAG run ID for DAG-run events
    - `attemptId` string — Attempt ID for DAG-run events
    - `sessionId` string — Session ID for LLM usage events
    - `userId` string — User ID associated with the event
    - `model` string — Model name associated with the event
    - `status` string — Status associated with the event when applicable
    - `data` object — Small event-specific payload
  - `total` integer — Total number of entries matching the filter when using compatibility offset pagination
  - `nextCursor` string — Opaque cursor for loading the next page of older entries when using cursor pagination

## Other responses

- `400` — Malformed cursor or invalid pagination parameters
- `401` — Not authenticated
- `403` — Forbidden - requires manager or admin role
- `default` — Unexpected error

---

[API](https://skmtc.net/dagucloud/apis/dagu.md) · [All operations](https://skmtc.net/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dagucloud/dagu/revisions/93cc41f2018a/schema)