# ListenSessionEventsDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

A poll's response.

## Fields
- `events` (array<[ListenSessionEventDto](https://devportal.demo.winkpg.io/docs/api/models/ListenSessionEventDto.md)>): Events after the cursor, oldest first. (nullable)
  Fields of each item:
  - `id` (string(uuid)): The staged-event id. The client's dedupe key across the cursor's overlap window.
  - `stagedAtUtc` (string(date-time)): When the event was staged. The first half of the cursor.
  - `eventId` (string): The platform event id, forwarded as `X-WinkPG-Event-Id`. (nullable)
  - `eventType` (string): Canonical event type. (nullable)
  - `deliveryId` (string(uuid)): The per-staged-event delivery id, forwarded as `X-WinkPG-Delivery-Id`.
  - `isSample` (boolean): Whether this event was staged by a sample request rather than a live occurrence. When true, the  forward to the local target carries `X-WinkPG-Sample: true`, the same marker a sample sent  to a saved endpoint carries. The body is identical either way.
  - `payload` (string): The webhook body, verbatim. Forwarded to the local target byte for byte: re-serializing it  client-side would change the bytes the signature covers and break verification. (nullable)
- `nextCursorUtc` (string(date-time)): The cursor to send on the next poll: the staging instant of the last event returned, or the  cursor the caller sent when nothing was returned. (nullable)
- `agedOutGap` (boolean): Set when the caller's cursor predates the oldest event still buffered, meaning events expired  before they were read.
- `oldestAvailableUtc` (string(date-time)): The staging instant of the oldest event still buffered, when there is a gap. (nullable)
- `expiresAtUtc` (string(date-time)): When the session now expires, after this poll renewed it.

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.