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

# List events

`GET /events`

Returns a list of event definitions (track events) for the authenticated project. Events are emitted by the SDK and represent subscription lifecycle and user behavior.

## Query parameters

- `limit` integer
- `offset` integer
- `sort_order` 'asc' | 'desc'

## Response `200`

A list of events.

- object
  - `object` string
  - `url` string
  - `data` V4Event[]
    - `object` 'event'
    - `id` string — Event ID.
    - `url` string — Canonical API path.
    - `event_name` string, nullable — Name of the event (e.g. trial_started, subscription_renewed).
    - `customer_uid` string, nullable — Customer UID associated with the event.
    - `happened_at` string, date-time — When the event occurred (ISO 8601).
  - `has_more` boolean

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `502` — Storage error
- `504` — Upstream timeout

---

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