---
title: "Get latest received event sample"
method: GET
path: "/events/sample"
tags: ["Events"]
---

# Get latest received event sample

`GET /events/sample`

Requires subscribers:read and company access. Reads the latest retained exact-name event across workspace subscribers, including older history. Trims surrounding whitespace; does not resolve aliases. No additional recent-only cutoff. Equal timestamps have no guaranteed tie order. Copy sample.properties into a sequence test run customVariables object; the test recipient is unchanged. This read has no side effects and can be retried safely.

## Query parameters

- `eventName` string, required

## Response `200`

Latest retained event, or sample null when none exists

- object
  - `eventName` string, required
  - `sample` object, nullable, required
    - `eventTime` string, required — UTC event timestamp
    - `subscriberId` string, required — Source subscriber ID; may differ from your test recipient
    - `properties` object, required — Recorded payload, preserving nested JSON; may be empty

## Other responses

- `400` — Missing or blank eventName, or missing company selection
- `401` — Missing or invalid authentication
- `403` — Missing subscribers:read scope or company access
- `500` — Analytics lookup failed; safe to retry this read

## Changes

- **2026-09-11** `1938006077ff` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/events/sample/get.md)

---

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