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

# List events

`GET /events`

Retrieve events, optionally filtered by name, resource ID, or creation time.

## Query parameters

- `name` string — Filter by fully-qualified event name, e.g. `customer.created`.
- `resource[id]` string — Filter by the resource ID that the events describe.
- `created[gt]` string, date-time — Return events created strictly after this timestamp.
- `created[gte]` string, date-time — Return events created on or after this timestamp.
- `created[lt]` string, date-time — Return events created strictly before this timestamp.
- `created[lte]` string, date-time — Return events created on or before this timestamp.

## Response `200`

OK

- Event[]
  - `created_at` string, date-time, required — Time the event was recorded.
  - `data` object, required — Event-specific payload data.
  - `id` string, required — Unique resource identifier.
  - `name` string, required — Fully qualified event name, such as `customer.created`.
  - `resource` EventResource, required
    - `id` string, required — ID of the resource the event relates to.
    - `resource_type` string, required — Canonical resource type.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.net/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/revisions/5b4c43e2941b/schema)