---
title: "List field events"
method: GET
path: "/records/{id}/field-events"
tags: ["Records"]
---

# List field events

`GET /records/{id}/field-events`

## Request

- Base URL: `https://klaaro.ai/api/v1`
- URL: `https://klaaro.ai/api/v1/records/{id}/field-events`
- Auth: HTTP bearer

Field and record-level events for a record.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `fieldPath` string
- `kinds` string: Comma-separated event kinds
- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `data` FieldEvent[]
    - `id` string, required: UUID for native field_events rows; legacy-mapped rows use `legacy:annotation:{uuid}` or `legacy:comment:{uuid}`.
    - `recordId` string, uuid, required
    - `fieldPath` string, required: Empty string for record-level events (e.g. comments).
    - `kind` 'value_edit' | 'unsure_flagged' | 'unsure_resolved' | 'confirmed' | 'reviewed_unchanged' | 'comment' | 'evidence_added' | 'validation_failed', required
    - `actorKind` 'user' | 'model' | 'system' | 'api_key', required
    - `body` string, nullable
    - `priorValue` unknown
    - `newValue` unknown
    - `parentEventId` string, uuid, nullable
    - `metadata` object
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `meta` ListMeta
    - `nextCursor` string, nullable, required
    - `hasMore` boolean, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited

---

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