---
title: "List recent events by cursor"
method: GET
path: "/dashboard/events/cursor"
tags: ["Operations"]
---

# List recent events by cursor

`GET /dashboard/events/cursor`

## Request

- Base URL: `https://plainrouter.com/api/v1`
- URL: `https://plainrouter.com/api/v1/dashboard/events/cursor`
- Auth: HTTP bearer

Returns retained customer-readable events using stable cursor pagination and aggregate destination-delivery acceptance metrics.

## Query parameters

- `per_page` integer
- `cursor` string

## Response `200`

Cursor-paginated events and delivery acceptance metrics.

- object
  - `events` object, required
    - `data` object[], required
      - `id` string, required
      - `workspace_id` integer, required
      - `signal_tracker_id` string, required: Deprecated alias of workspace_id; contains the workspace ID in decimal string form.
      - `parent_event_id` string, nullable, required
      - `event_name` string, required
      - `event_time` string, required
      - `action_source` string, required
      - `event_class` string, required
      - `order_id` string, nullable, required
      - `value_amount` integer, nullable, required
      - `value_currency` string, nullable, required
      - `created_at` string, required
      - `consent_basis` string, required
      - `measurement_class` string, required
      - `attribution_join` string, required
      - `enforcement_scope` string, required
      - `consent_normalization_version` string, required
      - `consent` union, required
        - object
        - unknown[]
          - unknown
      - `user_data_hashed` union, required: Deprecated compatibility field. The value is always null; delivery identity is never returned.
        - object
        - unknown[]
          - unknown
      - `click_ids` union, required
        - object
        - unknown[]
          - unknown
      - `session` union, required
        - object
        - unknown[]
          - unknown
      - `value_data` union, required
        - object
        - unknown[]
          - unknown
      - `event_source` string, nullable, required
      - `payload_expired` boolean, required
      - `deliveries` object[], required
        - `id` integer, required
        - `workspace_id` integer, required
        - `signal_tracker_id` string, required: Deprecated alias of workspace_id; contains the workspace ID in decimal string form.
        - `event_id` string, required
        - `destination_id` string, nullable, required
        - `status` 'queued' | 'sent' | 'held' | 'accepted' | 'retrying' | 'failed:auth' | 'failed:permanent' | 'failed:unknown' | 'expired' | 'skipped:consent' | 'skipped:no_destination' | 'skipped:duplicate' | 'skipped:lifecycle', required
        - `is_test` boolean, required
        - `attempt_count` integer, required
        - `last_error` union, required
          - object
          - unknown[]
            - unknown
        - `platform_response` union, required
          - object
          - unknown[]
            - unknown
        - `platform_trace_id` string, nullable, required
        - `next_attempt_at` string, nullable, required
        - `upload_deadline_at` string, nullable, required
        - `freshness_basis` string, nullable, required
        - `created_at` string, required
        - `updated_at` string, nullable, required
    - `path` string, nullable, required
    - `per_page` integer, required
    - `next_cursor` string, nullable, required
    - `next_page_url` string, nullable, required
    - `prev_cursor` string, nullable, required
    - `prev_page_url` string, nullable, required
  - `metrics` object, required
    - `accepted` integer, required
    - `total_deliveries` integer, required
    - `acceptance_rate` number, nullable, required
    - `acceptance_rate_window` string, required

## Other responses

- `401`: Invalid or missing Server secret.

---

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