---
title: "List tenant events"
method: GET
path: "/v1/events"
tags: ["Events"]
---

# List tenant events

`GET /v1/events`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/events`
- Auth: HTTP bearer

Newest-first feed of platform events (document.extracted, run.*.completed/failed, result.flagged/approved/rejected, delivery.item.*, case.resolved, and the Field Registry lifecycle family field.graduated / field.promoted / field.demoted / field.merged / field.renamed — every payload names the concept by stable `field_id`, so a consumer caching /v1/fields can invalidate instead of polling). Also carries the external-work family: app.decision_task.offered and agent_task.offered (each written in the same transaction as the task row it announces, so the task is always loadable when the event is visible) and app.run.sealed (a sealed App run, with record_set_id / subjects when the sealed record names them). The exhaustive list is /v1/delivery/catalog/signals. Alias of /v1/delivery/events at the API root.

## Query parameters

- `event_type` string
- `limit` integer
- `offset` integer
- `after` string
- `since` string, date-time

## Response `200`

{ data: [{ id, event_type, payload, created_at }], total, limit, offset, next_cursor } — next_cursor is the resume point (the last id scanned) and null only on an empty page. Events naming documents the caller may not see are omitted (Sources-IAM); an app service key additionally sees only events its grants cover.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)