---
title: "Your workspace's outcome record, newest first, typed per kind. Requires trail:read. Free."
method: GET
path: "/v1/trail"
tags: ["Guard"]
---

# Your workspace's outcome record, newest first, typed per kind. Requires trail:read. Free.

`GET /v1/trail`

## Request

- Base URL: `https://api.layrcake.dev`
- URL: `https://api.layrcake.dev/v1/trail`
- Auth: HTTP bearer

## Query parameters

- `campaign_id` string, uuid
- `email` string
- `kind` string[]
- `since` string, date-time
- `until` string, date-time
- `view` 'record'
- `limit` integer
- `cursor` string

## Response `200`

Events and the cursor for older ones; record context only with view=record

- object
  - `result` union, required
    - object
      - `events` union[], required
        - union
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'verify_verdict', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'admitted', required
            - `detail` object, required
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'removed', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'capped', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'provider_correlated', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'queued', required
            - `detail` object, required
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'launch_requested', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'launched', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'launch_failed', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_requested', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approved', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'declined', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'consumed', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'expired', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'reply', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'bounce', required
            - `detail` object, required
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'stop', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'complaint', required
            - `detail` object, required
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'pause_requested', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'paused', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'resume_requested', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'resumed', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'spend_threshold_crossed', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'dnc_added', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'dnc_loosened', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'dnc_loosen_cancelled', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'reply_sent', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'reply_failed', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_superseded', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'completed', required
            - `detail` object, required
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_held', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_undone', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_cancelled', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_failed', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_change_requested', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_revised', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_reply_myself', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'tool_action', required
            - `detail` object, required
              - …
          - object
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'lead_status', required
            - `detail` object, required
              - …
      - `next_cursor` string, nullable, required
      - `evaluated_at` string, required
    - object
      - `events` union[], required
        - union
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'verify_verdict', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'admitted', required
            - `detail` object, required
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'removed', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'capped', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'provider_correlated', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'queued', required
            - `detail` object, required
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'launch_requested', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'launched', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'launch_failed', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_requested', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approved', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'declined', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'consumed', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'expired', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'reply', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'bounce', required
            - `detail` object, required
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'stop', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'complaint', required
            - `detail` object, required
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'pause_requested', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'paused', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'resume_requested', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'resumed', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'spend_threshold_crossed', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'dnc_added', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'dnc_loosened', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'dnc_loosen_cancelled', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'reply_sent', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'reply_failed', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_superseded', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'completed', required
            - `detail` object, required
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_held', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_undone', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_cancelled', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_failed', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_change_requested', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_revised', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'approval_reply_myself', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'tool_action', required
            - `detail` object, required
              - …
          - object
            - `record` object, required
              - …
            - `id` string, uuid, required
            - `observed_at` string, required
            - `source` 'route' | 'worker' | 'webhook' | 'console', required
            - `campaign_id` string, uuid, nullable, required
            - `campaign_lead_id` string, uuid, nullable, required
            - `reply_id` string, uuid, nullable, required
            - `request_id` string, uuid, nullable, required
            - `operation_id` string, uuid, nullable, required
            - `email` string
            - `kind` 'lead_status', required
            - `detail` object, required
              - …
      - `approvals` object[], required
        - `approval_id` string, uuid, required
        - `command_id` string, uuid, nullable, required
        - `chain_id` string, uuid, nullable, required
        - `command_version` integer, nullable, required
        - `instance_number` integer, nullable, required
        - `command_hash` string, nullable, required
        - `content_digest` string, nullable, required
        - `state` 'draft' | 'pending_approval' | 'held' | 'approved' | 'queued' | 'executing' | 'declined' | 'expired' | 'superseded' | 'cancelled' | 'failed' | 'completed' | 'execution_failed', nullable, required
        - `campaign_id` string, uuid, nullable, required
        - `reply_id` string, uuid, nullable, required
        - `superseded_by_id` string, uuid, nullable, required
        - `ledger` object, nullable, required
          - `found` integer, required
          - `left_out` object[], required
            - `category` 'opted_out' | 'do_not_contact' | 'invalid' | 'platform_blocked' | 'contacted_recently' | 'capped' | 'other' | 'said_no_since_drafted', required
            - `count` integer, required
          - `included` integer, required
        - `decisions` object[], required
          - `id` string, uuid, required
          - `revision` integer, required
          - `decision` 'approve' | 'hold' | 'decline' | 'undo' | 'supersede' | 'cancel' | 'expire' | 'request_change' | 'revise' | 'reply_myself', required
          - `command_hash` string, required
          - `actor` object, required
            - `kind` 'person' | 'key' | 'system', required
            - `ref` string, uuid, nullable, required
            - `label` string, required
            - `label_basis` 'current_retained_label', required
          - `channel` string, nullable, required
          - `for_client` boolean, required
          - `reverses_decision_id` string, uuid, nullable, required
          - `decided_at` string, required
        - `approving_decision_id` string, uuid, nullable, required
        - `operation_id` string, uuid, nullable, required
        - `request_id` string, uuid, nullable, required
        - `approved_first_send_at` string, nullable, required
        - `first_send_at` string, nullable, required
        - `execution` 'not_yet_run' | 'not_confirmed' | 'recorded_success' | 'recorded_failure', required
        - `settlement_event_ids` string[], required
        - `settlement_events` object[], required
          - `id` string, uuid, required
          - `kind` 'launched' | 'launch_failed' | 'reply_sent' | 'reply_failed', required
          - `observed_at` string, required
          - `campaign_id` string, uuid, nullable, required
          - `reply_id` string, uuid, nullable, required
          - `request_id` string, uuid, nullable, required
          - `operation_id` string, uuid, nullable, required
        - `coverage` object, required
          - `status` 'recorded' | 'partial' | 'unavailable', required
          - `reasons` string[], required
      - `next_cursor` string, nullable, required
      - `evaluated_at` string, required
      - `pagination` 'live_keyset', required

## Other responses

- `400`: Invalid filter or a cursor that does not belong to this workspace/query
- `403`: Key lacks trail:read

---

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