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

# List Events

`GET /events`

This endpoint enables you to fetch a list of events that have been created by the system.
You can use query parameters to filter the results by the `created_at` time using `created_at.lt`, `created_at.gt`, etc. and you can
`limit` the number of events returned.

Use `page_cursor` from the previous response to paginate through results. Use `order` to control sort direction (ASC or DESC by created_at).
Events returned will be ordered by `created_at` in ascending order by default.

## Query parameters

- `created_at.lt` string, date-time
- `created_at.lte` string, date-time
- `created_at.eq` string, date-time
- `created_at.gte` string, date-time
- `created_at.gt` string, date-time
- `limit` integer
- `type` string
- `is_test` boolean
- `order` 'DESC' | 'ASC'
- `page_cursor` string

## Response `200`

Success

- ListEventsResponse
  - `events` Event[] — Events ordered by `created_at` timestamp in the direction specified by the `order` parameter (ascending by default).
    - `id` string
    - `type` string
    - `object_type` string
    - `object` object
    - `created_at` string, date-time — The timestamp when the event was first created, RFC3339 format, like `YYYY-MM-DDTHH:MM:SS.sssZ`.
    - `undelivered_webhooks` integer
  - `next_page_cursor` string — Cursor to pass in the next request to fetch the next page. Empty when no more results.

## Other responses

- `400` — Bad Request
- `403` — Insufficient scopes

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/revisions/0687ca8c9a8d/schema)