---
title: "Get an event and delivery trace"
method: GET
path: "/events/{event}"
tags: ["Event"]
---

# Get an event and delivery trace

`GET /events/{event}`

## Request

- Base URL: `https://plainrouter.com/api/v1`
- URL: `https://plainrouter.com/api/v1/events/{event}`
- Auth: HTTP bearer

Returns one retained customer-readable event with lineage and destination delivery state for scoped troubleshooting and acceptance checks.

## Path parameters

- `event` string, required

## Response `200`

Event, lineage, and destination delivery state.

- object
  - `event` 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
  - `lineage` object, required
    - `parent` object, nullable, 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
    - `children` 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
    - `explanation` string, required

## Other responses

- `401`: Invalid or missing Server secret.
- `404`: Resource not found.

---

[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)