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

# List events

`GET /events`

## Query parameters

- `limit` integer
- `cursor` string
- `monitorId` string
- `eventType` 'tweet.new' | 'tweet.reply' | 'tweet.retweet' | 'tweet.quote' | 'tweet.media' | 'tweet.link' | 'tweet.poll' | 'tweet.mention' | 'tweet.hashtag' | 'tweet.longform' | 'profile.avatar.changed' | 'profile.banner.changed' | 'profile.name.changed' | 'profile.username.changed' | 'profile.bio.changed' | 'profile.location.changed' | 'profile.url.changed' | 'profile.verified.changed' | 'profile.protected.changed' | 'profile.pinned_tweet.changed' | 'profile.unavailable.changed' — Type of monitor event fired when account activity occurs.

## Response `200`

Event list

- object
  - `events` Event[], required
    - `id` string, required
    - `type` 'tweet.new' | 'tweet.reply' | 'tweet.retweet' | 'tweet.quote' | 'tweet.media' | 'tweet.link' | 'tweet.poll' | 'tweet.mention' | 'tweet.hashtag' | 'tweet.longform' | 'profile.avatar.changed' | 'profile.banner.changed' | 'profile.name.changed' | 'profile.username.changed' | 'profile.bio.changed' | 'profile.location.changed' | 'profile.url.changed' | 'profile.verified.changed' | 'profile.protected.changed' | 'profile.pinned_tweet.changed' | 'profile.unavailable.changed', required — Type of monitor event fired when account activity occurs.
    - `username` string — Account username, present for account monitor events.
    - `query` string — Keyword query, present for keyword monitor events.
    - `monitorId` string, required — Account monitor ID for account events, or keyword monitor ID for keyword events.
    - `monitorType` 'account' | 'keyword', required — Source monitor type.
    - `keywordMonitorId` string — Keyword monitor ID, present for keyword monitor events.
    - `occurredAt` string, date-time, required
    - `data` object, required
  - `hasMore` boolean, required
  - `nextCursor` string

## Other responses

- `401` — Unauthenticated
- `429` — Xquik tier rate limit exceeded. The response includes a `Retry-After` header with the number of seconds to wait before retrying.

---

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