---
title: "List or stream trail events"
method: GET
path: "/api/v1/trails/{trail_id}/events"
tags: ["Trails"]
---

# List or stream trail events

`GET /api/v1/trails/{trail_id}/events`

## Path parameters

- `trail_id` string, required

## Query parameters

- `type` string
- `after` integer
- `limit` integer

## Headers

- `Last-Event-ID` string

## Response `200`

JSON event page or SSE stream

- object
  - `events` object[], required
    - `id` string, required
    - `trail_id` string, required
    - `review_id` string, nullable, required
    - `actor_id` string, required
    - `event_type` string, required
    - `target_type` string, required
    - `target_id` string, required
    - `payload` object, nullable, required
    - `created_at` string, required

## Other responses

- `400` — Validation error
- `403` — Forbidden
- `404` — Not found or caller lacks trail access

---

[API](https://skmtc.dev/entire/apis/entire-api.md) · [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/entire/entire-api/revisions/1134b24b642f/schema)
