---
title: "List distinct events retained for webhook delivery"
method: GET
path: "/v1/events"
tags: ["webhooks"]
---

# List distinct events retained for webhook delivery

`GET /v1/events`

## Request

- Base URL: `https://api.octaneai.com`
- URL: `https://api.octaneai.com/v1/events`
- Auth: HTTP bearer

## Query parameters

- `topic` 'quiz.started' | 'quiz.finished' | 'quiz.abandoned' | 'identity.captured' | 'quiz.published' | 'experiment.started' | 'experiment.ended' | 'profile.created' | 'profile.updated' | 'export.completed' | 'webhook.endpoint.disabled', nullable
- `cursor` string, nullable: From the previous page's nextCursor
- `limit` integer

## Response `200`

One page of the store's retained events, newest first.

- EventList
  - `data` EventSummary[], required: The events, newest first
    - `id` string, required: The event, the webhook-id header
    - `type` string, required: The topic: quiz.started | quiz.finished | quiz.abandoned | identity.captured | quiz.published | experiment.started | experiment.ended | profile.created | profile.updated | export.completed | webhook.endpoint.disabled
    - `topic` 'quiz.started' | 'quiz.finished' | 'quiz.abandoned' | 'identity.captured' | 'quiz.published' | 'experiment.started' | 'experiment.ended' | 'profile.created' | 'profile.updated' | 'export.completed' | 'webhook.endpoint.disabled', required: The topic
    - `endpoint_id` string, required: The first endpoint the event was queued for
    - `created` string, date-time, required: When the event happened
  - `has_more` boolean, required: Whether another page follows
  - `next_cursor` string, nullable, required: Send as cursor for the next page; null on the last

## Other responses

- `401`: The key is missing, malformed, revoked or expired.
- `403`: The store's plan has no API access, or the key lacks the scope.
- `422`: A request parameter is invalid.
- `429`: The key's or the store's bucket is full; Retry-After says when to try again.
- `504`: The request timed out.

---

[API](https://skmtc.dev/octaneai/apis/octane-ai-merchant-api.md) - [All operations](https://skmtc.dev/octaneai/apis/octane-ai-merchant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/octaneai/apis/octane-ai-merchant-api/revisions/dc2d1aa2b7c6?raw)