---
title: "list events"
method: GET
path: "/events"
tags: ["events"]
---

# list events

`GET /events`

Retrieve an ordered and paginated list of all events in the authenticated environment.

## Query parameters

- `order` string
- `since_token` string
- `count` string
- `event_type` string

## Response `200`

successful

- ListEventsResponse
  - `events` EventResponse[] — Root element
    - `event` object
      - `id` string — The unique identifier for the event
      - `request_id` string — The X-REQUEST-ID HTTP header value of the request that generated the event
      - `event_type` string — The type of event that occurred, e.g., `AddGateway`, `UpdateMerchantProfile`
      - `object_type` string — The type of object that the event is associated with, e.g., `gateway`, `merchant_profile`
      - `object_key` string — The key of the object that the event is associated with, e.g., `6A8HT3R1XP9G78ABK04GM1957F`
      - `created_at` string — The time the event was created

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.dev/spreedly/apis/spreedly-api-v1.md) · [All operations](https://skmtc.dev/spreedly/apis/spreedly-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spreedly/spreedly-api-v1/revisions/72ba4e23e65c/schema)