---
title: "List events"
method: GET
path: "/api/v1/events"
tags: ["Events"]
---

# List events

`GET /api/v1/events`

Retrieve a paginated list of events.

## Query parameters

- `limit` integer
- `after` string
- `before` string

## Response `200`

Events list response

- EventListResponse
  - `pageInfo` object, required
    - `endCursor` string
    - `startCursor` string
    - `hasPreviousPage` boolean, required
    - `hasNextPage` boolean, required
  - `data` Event[], required
    - `id` string, required — Unique identifier for the event. This can be used as an idempotency key to avoid double-processing of the same underlying event.
    - `object` 'event', required
    - `type` union, required
      - 'checkout_intent.offer_retrieved' | 'checkout_intent.offer_failed' | 'checkout_intent.completed' | 'checkout_intent.order_failed'
      - 'shipment.created' | 'shipment.updated'
      - 'product.updated' | 'product.removed'
      - 'webhook_endpoint.verification_challenge'
    - `createdAt` string, required — Timestamp of when the event was created.
    - `source` EventSource, required — A reference to the object which triggered the event. You should use the API to fetch the full object details.
      - `id` string, required — ID of the object which triggered the event.
      - `type` 'checkout_intent' | 'shipment' | 'product' | 'webhook_endpoint', required
    - `data` EventData — The event data payload. The concrete shape depends on `source.type`. Refer to [webhook event types](https://docs.rye.com/api-v2/webhooks/types) for the payload shape associated with each `source.type`.

## Other responses

- `401` — Authentication Failed
- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.dev/rye-com/apis/universal-checkout-api.md) · [All operations](https://skmtc.dev/rye-com/apis/universal-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rye-com/universal-checkout-api/revisions/175c7f9e090e/schema)